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APPENDIX 



MSAvalon.Windows.Media 

The following tables list the members exposed by the MSAvalon.Windows.Media namespace. 



Classes 

ArcSegment 
AudioData 
AudioDataConverter 
BezierSegment 

Brush 

BrushConverter 
Brushes 

CloseSegment 

CodecFilter 

podeclnfo 

ColorCollection 

ColorCollectionConverter 

ColorContext 

ColorConverter 

Colors 

ContainerVisual 

DashArrays 

DoubleCollection 

DoubleCollectionConverter 

Drawing 

DrawingBrush 

DrawingContext 

DrawingVisual 

EllipseGeometry 

FontFamily 

FormattedText 
Geometry 

GeometryCollection 
GetPageEventArgs 



Represents an elliptical arc between two points. 

Enables playing of audio files according to the state of a time node. 

AudioDataConverter 

Represents a cubic Bezier curve drawn between two points. 
Provides a generic means for filling an area using solid colors (SolidColorBrush), 
gradients (LinearGradientBrush, RadialGradientBrush), images (ImageBrush), 
video, and more. 

Used to convert a Brush object to or from another object type. 
Implements a set of predefined solid colors. 

Represents a line that connects the last point of a PathFigure object with its starting 
point. 

Filter for enumerating codecs. Only those codecs that match the properties will be 
enumerated. 

Information about a specific codec and a factory for creating the codec. This is 
returned from the codec enumerator. 

ColorCollectionConverter - Converter class for converting instances of other types to 
and from ColorCollection instances. 

Used to convert a Color object to or from another object type. 
Implements a set of predefined colors. 
Manages a collection of Visual objects. 

DashArrays - The DashArrays class is static, and contains properties for well known 
dash styles. 

DoubleCollectionConverter - Converter class for converting instances of other types 
to and from DoubleCollection instances. 

A Drawing is a list of 2d drawing primitives. 

DrawingBrush - This TileBrush defines its content as a Drawing 

Drawing context. 

Visual that contains graphical content to be drawn. 
Represents the geometry of a circle or ellipse. 
Font family 

The FormattedText class is a part of Avalon MIL easy text API, which is targeted at 

programmers needing to add some simple text to a MIL visual. 

An abstract class that provides base functionality for all geometry classes, such as 

EllipseGeometry, RectangleGeometry, and PathGeometry. The Geometry class of 

objects can be used for clipping, hit-testing, and rendering 2-D graphic data. 

Represents a collection of Geometry objects. 

class GetPageEventArgs 
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GlyphRun 
GlyphTypeface 

GradientBrush 

GradientStop 

GradientStopCollection 

HitTestParameters 

HitTestResult 

Hwndlnterop 

HwndVisual 

HyphenationCandidate 

ICCProfile 

ImageBrush 

I mageCodecCollection 

ImageCodecEnumerator 

ImageColorTransform 

ImageData 

ImageDataBuilder 

ImageDecoder 

ImageDecoderBmp 

ImageDecoderGif 

ImageDecoderlcon 

I mageDecoderl nternal 

ImageDecoderJpeg 

ImageDecoderPng 

ImageDecoderTiff 

ImageEffect 



ImageEffectBlur 

ImageEffectFlipRotate 

ImageEffectGammaCorrect 

ImageEffectGlow 

ImageEffectGrayscale 

ImageEffectNegate 

ImageEffectSharpen 

ImageEffectSource 

ImageEffectSourceCollection 



Glyph run class 

Physical font face corresponds to a font file on the disk 

An abstract class that describes a gradient fill. Classes that derive from 

GradientBrush describe different ways of interpreting gradient stops. 

Describes the location and color of a transition point in a gradient. 

Represents a collection of GradientStop gradient stops. 

This is the base class for packing together parameters for a hit test pass. 

This base returns the visual that was hit during a hit test pass. 

Hwndlnterop 

Describes one Hyphenation candidate. 

Fills an area with an image. This class may be used to specify images as the fill or 
background of other objects. 

The collection of codecs (actually Codeclnfos) on the system. 
The enumerator for Image frames. 

ImageColorTransform Performs color management on an imaging pipeline. 

Contains an image and related data. 

This object is used to build an ImageData object. 

ImageDecoder is a container for image frames. Each image frame is an 

ImageSource. Unlike ImageSource, ImageDecoder is NOT an immutable object and 

can be re-initialized to a different image stream. However, any ImageSources 

(frames) that it returns must be immutable. 

The built-in Microsoft Bmp (Bitmap) Decoder. 

The built-in Microsoft GIF Decoder. 

The built-in Microsoft Icon Decoder. 

For internal use only. 

The built-in Microsoft Jpeg Decoder. 

The built-in Microsoft PNG Decoder. 

The built-in Microsoft Tiff Decoder. 

The ImageEffect class is the base class for all imaging effects (blur, grayscale, etc) 
It's possible for an effect to not have any inputs but an effect must always have at 
least one output. The default implementations of things assume this. If a derived 
effect is going to play with Output/Outputs be sure that at least one is there. 
Gaussian blur effect. It is a single input, single output effect. Warning: If the effect is 
being scaled (i.e. Input. ScaleX or Input.ScaleY isn't 1) and Expand is true, then it's 
possible for the output dimensions to be larger or smaller that PixelWidth and 
PixelHeight. Adjust the pixel buffer fed to copy to avoid problems. 
This effect can flip an image in X or Y and rotate by multiples of 90 deg 
This effect changes the gamma of an image 
Performs a glow effect. It is a single input, single output effect. 
Converts an image to grayscale. It is a single input, single output effect. 
Negates an image. It is a single input, single output effect. 
Unsharp mask. It is a single input, single output effect. 
ImageEffectSource class implementation 
The collection of image effect outputs 
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ImageEffectTint 

ImageEncoder 

ImageEncoderBmp 
ImageEncoderGif 

ImageEncoderlnternal 

ImageEncoderJpeg 

ImageEncoderPng 

ImageEncoderTiff 

ImageExchangeMetaData 

ImageExchangeProperty 

ImageMeiaData 

ImagePalette 
ImageSizeOptions 

ImageSource 

ImageSourceCollection 
ImageSourceConverter 
IntegerCollection 

IntegerCollectionConverter 

LinearGradientBrush 
LineGeometry 

LineSegment 

MatrixTransform 

MediaData 
MediaSystem 

NineGridBrush 

PathFigure 

PathFigureCollection 
PathFigureConverter 



Tint constructor. It is a single input, single output effect. 
ImageEncoder collects a set of frames (ImageSource's) with their associated 
thumbnails and metadata and saves them to a specified stream. In addition to 
frame-specific thumbnails and metadata, there can also be an image-wide (global) 
thumbnail and metadata, if the codec supports it. 

Built-in Encoder for Bmp files. 
Built-in Encoder for Gif files. 

ImageEncoderlnternal collects a set of frames (ImageSource's) with their associated 
thumbnails and metadata and saves them to a specified stream. In addition to 
frame-specific thumbnails and metadata, there can also be an image-wide (global) 
thumbnail and metadata, if the codec supports it. 

Built-in Encoder for Jpeg files. 

Built-in Encoder for Png files. 

Built-in Encoder for Tiff files. 

ImageExchangeMetaData This class is used to access and set metadata for 
ImageFiles which have Exif style metadata. MetaData is stored as Key/Value pairs, 
where Keys are not necessarily unique. This class provides generic access to all 
meta data within an image, as well as exposes CLR properties for certain well- 
known properties. 

ImageExchangeProperty - a tuple of an ImageExchangelD and the object which is 
the value of that property 

ImageMetaData This class is used to access and set metadata for Images. This 
class also exposes a CodecMetaData property which exposes a codec-specific 
means of accessing the metadata for this image. 

ImagePalette class 

Sizing options for an image. The resulting image will be scaled based on these 
options. 

Defines the methods, properties, and events for the imaging pipeline, including 
decoders and effects. 

The collection of codecs (actually ImageSource's) on the system. 
ImageSourceConverter 

IntegerCollectionConverter - Converter class for converting instances of other types 
to and from IntegerCollection instances. 

Defines a linear gradient used to fill an area. 

Represents the geometry of a line. 

Represents a line between two points. Unlike LineGeometry objects, LineSegment 
must be contained within a PathFigure. 

Creates an arbitrary affine matrix transformation used to manipulate objects or 
coordinate systems in a two-dimensional plane. 
MediaData. Use to playback Audio/Video content. 
The MediaSystem class controls the media layer. 

Fills an entire area with an image. Portions of the image are stretched to fit within 
defined margins. 

Represents a sub-section of a geometry, a single connected series of two- 
dimensional geometric segments. 



PathFigureConverter 
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PathGeometry 
PathGeometryConverter 

PathSegment 

PathSegmentCollection 
PathSegmentConverter 
Pen 

PixelFormats 
PointCollection 

PointCollectionConverter 

PointHitTestParameters 

PointHitTestResult 

PolyBezierSegment 

PolyLineSegment 

PoiyQuadraticBezierSegment 

PrintContext 

QuadraticBezierSegment 

RadialGradientBrush 

RectangleGeometry 

RetainedVisual 

RotateTransform 

ScaleTransform 

SkewTransform 
SolidColorBrush 
StartSegment 

SubLineCollection 
TileBrush 



Transform 

TransformColleciion 

TransformConverter 

TranslateTransform 

Typeface 

VectorCollection 

VectorCollectionConverter 



Represents a complex shape that may be composed of arcs, curves, ellipses, lines 
and rectangles. 

PathGeometryConverter 

An abstract class that represents a segment of a PathFigure object. Classes that 

derive from PathSegment, such as ArcSegment, BezierSegment, and LineSegment, 

represent specific types of geometric segments. 

Represents a list of PathSegment objects. 

PathSegmentConverter 

Describes how a shape is outlined. 

PixelFormats - The collection of supported Pixel Formats 

PointCollectionConverter - Converter class for converting instances of other types to 
and from PointCollection instances. 

This is the class for specifying parameters hit testing with a point. 

This class returns the point and visual hit during a hit test pass. 

PolyBezierSegment 

PolyLineSegment 

PoiyQuadraticBezierSegment 

PrintContext holds state and context for a printer interation 
QuadraticBezierSegment 

Defines a radial gradient used to fill an object. A focal point defines the beginning of 
the gradient, and a circle defines the end point of the gradient. 
Represents the geometry of a rectangle. 
RetainedVisual 

Used to rotate an object about a specified point in the two-dimensional x-y plane. 
Scales an object in the two-dimensional x-y plane, starting from a defined center 
point. Scale factors are defined in x- and y-directions from this center point. 
Represents a two-dimensional skew. 
Represents a solid, uniform fill. 
StartSegment 

collection of subline. Subline can be object of one of these types GlyphRun 
LineOver Inline object 

Abstract class that describes a way to fill a region with one or more "tiles." Derived 
classes define the different types of tiles that can be used; for example, the 
ImageBrush enables you to fill an area with an image. 

An abstract class that you use as the parent class of all types of transformations in a 

two-dimensional plane, including rotation (RotateTransform), scale 

(ScaleTransform), skew (SkewTransform), and translation (TranslateTransform). 

This class hierarchy differs from the Matrix structure both because it is a class and 

because it supports animation and enumeration semantics. 

Used to create and manipulate a list of Transform objects. 

Used to convert a Transform object to or from another object type. 

Translates an object in the two-dimensional x-y plane. 

A Typeface is a combination of family, weight, style and stretch: 

VectorCollectionConverter - Converter class for converting instances of other types 
to and from VectorCollection instances. 



4 



VideoData 
VideoDataConverter 

Visual 

VisualCollection 
VisualManager 

Interfaces 

I Hyphenate 

IRetainedRender 

(Visual 

Enumerations 

BrushMappingMode 

ChannelDescription 

Colorl nterpolation Mode 

CombineMode 
FillRule 

GradientSpreadMethod 

HitTestFilterBehavior 
H itTestResultBeha vior 

HorizontalAlignment 

HyphenationRule 

ImagePaletteType 

MediaState 

PenDashCap 

PenLineCap 
PenLineJoin 
Rotation 

StandardColorSpace 
Stretch 

StyleSimulations 
TiffCompressOptions 
TileMode 
VerticalAlignment 



Enables playing of video files according to the state of a time node. 
VideoDataConverter 

Base class for all Visual types. It provides services and properties common to all 
Visuals, including hit-testing, coordinate transformation, and bounding box 
calculations. 

An ordered collection of Visual objects. 

Renders a tree of Visual objects to a rendering target, typically a window. 



I Hyphenate is the interface for Hyphenation Service Provider 
If this interface is implemented on a class that is derived from a RetainedVisual, the 
RetainedVisual operations in validation mode, i.e. the graphics sub-system will call 
OnRender in a lazy fashion, (e.g. if the Visual appears for the first time on the 
screen). Note that OnRender can be called by the system anytime. 

This interface defines the common methods and services available from a Visual 
object. 



BrushMappingMode - Enum which describes whether certain values should be 
considered as absolute local coordinates or whether they should be considered 
multiples of a bounding box's size. 

Describes order of each channel of pixel data 

ColorlnterpolationMode - This determines how the colors in a gradient are 
interpolated. 

Specifies the method used to combine two geometric areas. 

Specifies how the gradient should be drawn outside of the specified gradient vector 
or space. 

Behavior for filtering visuals while hit tesitng 

Enum controls behavior when a positive hit occurs during hit testing. 

The HorizontalAlignment enum is used to describe how content is positioned 
horizontally within a container. 

Supported Hyphenation Rules. 

Pre-defined palette types 

Holds the current state of the Media 

PenDashCap - Enum which descibes the drawing of the ends of a dash within a 
dashed line. 

Describes the shape at the end of a line or segment. 

PenLineJoin - Enum which descibes the drawing of the corners on the line. 

The rotation to be applied; only multiples of 90 degrees is supported. 

Stretch - Enum which descibes how a source rect should be stretched to fit a 
destination rect. 

Font style simulation 

Compress options for saving TIFF image 

TileMode - Enum which descibes the drawing of the ends of a line. 

The VerticalAlignment enum is used to describe how content is positioned vertically 
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within a container. 



Structures 

Characterlndexer 
Color 

Glyphlndexer 
ImageExchangelD 

ImageExchangeMetaDataEnume 
rator 

ImageFrameEnumerator 

ImageMetaDataRational 

ImageMetaDataUnsignedRationa 
I 

ImagePaletteColor 
IntegerRect 

Matrix 

NamedStringlndexer 
PixelFormat 

Delegates 

GetPageEventHandler 
HitTestFilterDelegate 
HitTestResultDelegate 



This class is a helper to implement named indexers for characters. 
Represents colors in terms of alpha, red, green, and blue channels. 
This class is a helper to implement named indexers for glyph metrics. 
ImageExchangelD - This class is the type which can be used as the key for a 
property in an ImageMetaData instance. This can be either an integer or a string. 
ImageExchangeMetaDataEnumerator The enumerator for 

ImageExchangeMetaData. Contains Enumerator interface as well as strongly typed 
versions of the APIs 

The enumerator for Image frames. 

An ImageMetaDataRational class is represented as a signed numerator and a 
signed denominator. The effective value of a rational is the numerator / demoninator 
A rational class is represented as an unsigned numerator and an unsigned 
denominator. The effective value of a rational is the numerator /demoninator 
ImagePaletteColor structure 

A rect composed of integer values. Typically used to specify the source rect (in 
pixels) of interest from an image. 

Represents a 3x3 matrix used for transformations in two-dimensional space. 
Because "Avalon" only allows affine transformations, the Matrix structure has six 
entries instead of nine. 

This class is a helper to implement named indexers for strings localized in multiple 
cultures. 

Pixel Format Definition for images and pixel-based surfaces 



delegate GetPageEventHandler 

Delegate for hit tester to control whether to test against children of visual. 
Delegate for hit tester to control returning of hit information on visual. 
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MSAvalon.Windows.Media 



CLASSES 

ArcSegment Class 

Definition: Represents an elliptical arc between two points. 



Method 

ArcSegment 

CloneCore 

CloneCore 

CloneDownToUnchangeable 

Copy 
Copy 

Copy 

DisabieCore 

EmbeddedAnimationCollectionReader 

EmbeddedAnimationCollectionWriter 

EmbeddedChangeableReader 

EmbeddedChangeableWriter 

EnableCore 

Equals 
Finalize 

GetCurrentValue 
GetCurrentValue 
GetCurrentValue 

GetHashCode 
GetType 

MakeUnchangeable 
MakeUnchangeableCore 



Description 

Initializes a new instance of the ArcSegment class. 
Returns a modifiable shallow or deep clone of the current 
object. This abstract method must be implemented by classes 
that derive from Changeable. Inherited from Changeable. 
Implementation of Animatable.CloneCore. 

Returns an immutable copy of the specified object. Inherited 
from Changeable. 

Creates a copy of this PathSegment. Inherited from 
PathSegment. 

Creates a copy of this ArcSegment. 

Returns a modifiable copy of the current object. The copy's 
IsChangeable property is true and its StatusOfNextUse is 
Unchangeable. Inherited from Changeable. 

Inherited from PathSegment. 

Maybe this should be internal?? Inherited from Animatable. 
Inherited from Animatable. 
Inherited from Animatable. 
Inherited from Animatable. 
Inherited from PathSegment. 

Determines whether two Object instances are equal. Inherited 
from Object. 

Allows an Object to attempt to free resources and perform 
other cleanup operations before the Object is reclaimed by 
garbage collection. Inherited from Object. 

Returns a non-animated version of this GradientStop that 
represents its current state. Inherited from PathSegment. 

Returns a non-animated version of this ArcSegment that 
represents its current state. 

Returns a non-animated version of this Animatable that 
represents its current state. Inherited from Animatable. 
Serves as a hash function for a particular type, suitable for use 
in hashing algorithms and data structures like a hash 
table. Inherited from Object. 

Gets the Type of the current instance. Inherited from Object. 
Makes an object immutable; after this method is called on a 
Changeable, its IsChangeable property is false. Inherited from 
Changeable. 

Implementation of MakeUnchangeableCore. Inherited from 
PathSegment. 
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IsOverriding Base Value 
IsStroked 

LargeArc 
Point 

PointAnimations 
Size 

SizeAnimations 

StatusOfNextUse 

SweepFlag 

UlContext 

XRotation 

XRotationAnimations 



Gets or sets a Boolean that determines whether the segment is 
stroked. Inherited from PathSegment. 

Gets or sets a Boolean that determines whether the arc is drawn 
with a sweep of 180 degrees or greater. 
Gets or sets the endpoint of the elliptical arc. 

Gets or sets a collection of PointModifier objects that animate the 
destination Point of the elliptical arc. 

Gets or sets The x- and y-radius of the elliptical arc. 

Gets or sets a collection of SizeModifier objects that animate the 
size of the elliptical arc. 

Gets or sets a UseStatus enumeration that specifies how the 

Changeable object behaves when it is "used." A Changeable object 

is considered used in the following situations: the object is set into a 

Property System property, the object is used as a sub-object in a 

complex Changeable object, or the object is used in a 

DrawingContext command. Inherited from Changeable. 

Gets or sets a Boolean that determines whether the arc is drawn in 

a positive-angle or negative-angle direction. 

Gets the UlContext of the current object. The UlContext is used for 

maintaining thread safety. Inherited from Changeable. 

Gets or sets a value that indicates how the ellipse is rotated relative 
to the current coordinate system. 

Gets or sets a collection of DoubleModifier objects that animate x- 
axis rotation factor of the elliptical arc. 



Use a PathFigure object to store ArcSegment objects and other segments. 
An elliptical arc is defined by its start and end points, x- and y-radius, x-axis rotation factor a flag 
indicating how large the angle of the resulting arc should be, and another flag describing which direction 
the arc is drawn. The ArcSegment class does not contain a property for the starting point of the arc it 
only defines the destination point of the arc it represents. The beginning point of the arc is the current 
point of the PathFigure to which the ArcSegment is added. 

For most elliptical arcs of a particular position, size, and rotation, there are four different arcs that can be 
drawn; the LargeArc and SweepFlag properties indicate which arc to use. 

Of the four candidate arc sweeps, two represent large arcs with sweeps of 180 degrees or greater and 
two represent smaller arcs with sweeps 180 degrees or less. If LargeArc is true, then one of the two 
larger arc sweeps is chosen; otherwise, if LargeArc is false, one of the smaller arc sweeps is chosen. 

If SweepFlag is true, the arc is drawn in a positive-angle direction. If SweepFlag is false the arc is drawn 
in a negative-angle direction. 



AudioData Class 

Definition: Enables playing of audio files according to the state of a time node. 

Method Description 

AudioData Initializes a new instance of the AudioData class. 

Be 9 inin Schedules an interactive begin time. Inherited from MediaData. 

CloneCore Clones this MediaData. 

CloneDownToUnchangeable Returns an immutable copy of the specified object. Inherited from 
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MemberwiseClone 

ModifyHandlerlfChangeable 

OnChanged 

PropagateEventHandler 
ReadPreamble 

ReferenceEquals 

SetDefaultParentTimeline 

SetDefaultParentTimelineCore 
ToString 

ValidateObjectState 
WritePostscript 

WritePreamble 



Creates a shallow copy of the current Object. Inherited from 

Object. 

Adds or removes a Changed event handler to or from the 
specified Changeable object, if the object is currently 
modifiable. If the specified object is not modifiable— if its 
IsChangeable property is false— this method has no 
effect. Inherited from Changeable. 

Called when the current object is modified. Classes that derive 
from Changed should call this method after they have been 
modified. Inherited from Changeable. 

Ensures that simple (non-Changeable) members are being 
accessed from a valid Ul context. This method should be 
called before any simple members are accessed. Inherited 
from Changeable. 

Determines whether the specified Object instances are the 
same instance. Inherited from Object. 

This will change the time parent for animations on any of the 
properties of this Changeable which are inheriting their time 
parent. Inherited from Animatable. 

Inherited from PathSegment. 

Returns a String that represents the current Object. Inherited 
from Object. 

Verifies that the current object has a valid state. If the object is 
in an invalid state, this method throws an exception. Inherited 
from Changeable. 

Causes the current object to validate itself and then invokes 
the OnChanged method. Inherited from Changeable. 
Ensures that simple (non-Changeable) members are being 
accessed from a valid user interface (Ul) context. This method 
should be called before any simple members are set. Inherited 
from Changeable. 



Property Description 

Used in conjunction with the ChangeableUsageOverride type sent in 

AllowChangeableReferenceOverride * s a P arameter t0 ChangeableHelper.UseChangeable, to help 

determine when a Changeable being put into "use" should be 
promoted to "ChangeableReference". Inherited from Changeable. 

True if this Changeable can be made unchangeable. Inherited from 
Changeable. 

The current parent Timeline associated with this Animatable. This 
will be the Timeline set to the ParentTimeline property of this 
Animatable if one has been set and if not, the Timeline last passed 
into the SetDefaultParentTimeline method. Inherited from 
Animatable. 



CanMakeUnchangeable 



DefaultParentTimeline 



HasAnimations 
IsAnimating 

IsChangeable 



Gets a Boolean that indicates whether the segment has animations. 

Gets a Boolean that indicates whether the object is currently 
modifiable. Inherited from Changeable. 
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Copy 

Disable 
Dispose 



Changeable. 

Returns a modifiable copy of the current object. The copy's IsChangeable 
property is true and its StatusOfNextUse is Unchangeable. Inherited from 
Changeable. 

Disables this timeline, after which the timeline can no longer become 
active. The timeline can be re-enabled with a call to Enable. Inherited 
from MediaData. 



Dispose the object. Inherited from MediaData. 
Accesses the specified Changeable data member, processes it, and 
returns a reference to the member. This reference should then be 
EmbeddedChangeableReader reassigned to the original member variable. Classes that derive from 

Changeable call this method on data members before they can be 
retrieved through property calls. Inherited from Changeable. 
Processes a modified Changeable data member and returns a reference 
to the processed object. Inherited from Changeable. 
Enables this timeline, parenting it to the timeline specified by the 
ParentTimeline property. This allows the timeline to become active. This 
method throws an exception if the ParentTimeline property is 
null. Inherited from MediaData. 



EmbeddedChangeableWriter 



Enable 



Endln 

Equals 

Finalize 



Schedules an interactive end time. Inherited from MediaData. 

Determines whether two Object instances are equal. Inherited from 
Object. 

Finalizes the MediaData. Inherited from MediaData. 



GetHashCode 
GetType 

MakeUnchangeable 

MakeUnchangeableCore 
MemberwiseClone 



Serves as a hash function for a particular type, suitable for use in 
hashing algorithms and data structures like a hash table. Inherited from 
Object. 

Gets the Type of the current instance. Inherited from Object. 
Makes an object immutable; after this method is called on a Changeable, 
its IsChangeable property is false. Inherited from Changeable. 
Implementation of MakeUnchangeableCore. Inherited from MediaData. 
Creates a shallow copy of the current Object. Inherited from Object. 
Adds or removes a Changed event handler to or from the specified 
ModifyHandlerlfChangeable Chan 9eable object, if the object is currently modifiable. If the specified 

object is not modifiable— if its IsChangeable property is false— this 
method has no effect. Inherited from Changeable. 
Called when the current object is modified. Classes that derive from 
Changed should call this method after they have been modified. Inherited 
from Changeable. 

Pauses this media. Inherited from MediaData. 



OnChanged 



Pause 
Play 

PropagateEventHandler 
ReadPreamble 

ReferenceEquals 

Resume 

Seek 

ToString 



Begins playback of media. Inherited from MediaData. 
Propogates event handler to the timeline Inherited from MediaData. 
Ensures that simple (non-Changeable) members are being accessed 
from a valid user interface (Ul) context. This method should be called 
before any simple members are accessed. Inherited from Changeable. 
Determines whether the specified Object instances are the same 
instance. Inherited from Object. 

Resumes this media. Inherited from MediaData. 

Moves the timeline for this media. Inherited from MediaData. 

Persist MediaData in a string Inherited from MediaData. 
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ValidateObjectState 
WritePostscript 

WritePreamble 



Verifies that the current object has a valid state. If the object is in an 
invalid state, this method throws an exception. Inherited from 
Changeable. 

Causes the current object to validate itself and then invokes the 
OnChanged method. Inherited from Changeable. 

Ensures that simple (non-Changeable) members are being accessed 
from a valid Ul context. This method should be called before any simple 
members are set. Inherited from Changeable. 



Acceleration 



Property Description 

Accesses the Acceleration SMIL attribute. Inherited from 
MediaData. 

Used in conjunction with the ChangeableUsageOverride type sent in 

AllowChangeableReferenceOverride ? 4 a P arame * er t0 ChangeableHelper.UseChangeable, to help 

determine when a Changeable being put into "use M should be 
promoted to "ChangeableReference". Inherited from Changeable. 

Accesses the AutoReverse SMIL attribute. Inherited from 
MediaData. 

Accesses the Begin SMIL attribute. Inherited from MediaData. 

True if this Changeable can be made unchangeable. Inherited from 
Changeable. 

The current repetition iteration. Inherited from MediaData. 

The current time local to this media. Inherited from MediaData. 

Accesses the Deceleration SMIL attribute. Inherited from 
MediaData. 

Accesses the Duration SMIL attribute. Inherited from MediaData. 

Accesses the End SMIL attribute. Inherited from MediaData. 

Accesses the EndSync SMIL attribute. Inherited from MediaData. 

Accesses the Fill SMIL attribute. Inherited from MediaData. 

Accesses the FillDefault SMIL attribute. Inherited from MediaData. 

True if the media has audio output. Inherited from MediaData. 

True if the media has changed since the last tick. Inherited from 
MediaData. 

True if the media has a visual output. Inherited from MediaData. 

Get the video Height in pixels Inherited from MediaData. 

Gets a Boolean that indicates whether the object is currently 
modifiable. Inherited from Changeable. 

True if the media is active, false otherwise. Inherited from 
MediaData. 



AutoReverse 
Begin 

CanMakeUnchangeable 

CurrentRepeat 
CurrentTime 

Deceleration 

Duration 
End 

EndSync 
Fill 

FillDefault 
HasAudio 

HasChanged 

HasVideo 
Height 

IsChangeable 
IsChanging 



IsEnabied 

IsForward Progressing 

IsOverriding Base Value 

IsPaused 

IsReversed 

MediaDuration 



True if the media is enabled, false otherwise. Inherited from 
MediaData. 

True if the media is moving from past to future. Inherited from 
MediaData. 

True if the media is either changing or in a fill state, false 
otherwise. Inherited from MediaData. 

True if this media is paused. Inherited from MediaData. 

True if this media is in a reverse period. Inherited from MediaData. 

Returns the native media duration. Inherited from MediaData. 
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Mute 

ParentTimeline 
Progress 

RepeatCount 

RepeatDuration 

Restart 

RestartDefault 

Speed 
State 

StatusOfNextUse 



UlContext 

Volume 
Width 



Accesses the mute state of media playback. Inherited from 
MediaData. 

Accesses the ParentTimeline attribute. Inherited from MediaData. 

The current progress of the media, from 0 to 1. Inherited from 
MediaData. 

Accesses the RepeatCount SMIL attribute. Inherited from 
MediaData. 

Accesses the RepeatDuration SMIL attribute. Inherited from 
MediaData. 

Accesses the Restart SMIL attribute. Inherited from MediaData. 

Accesses the RestartDefault SMIL attribute. Inherited from 
MediaData. 

Accesses the Speed SMIL attribute. Inherited from MediaData. 
Returns the current state of the media. Inherited from MediaData. 
Gets or sets a UseStatus enumeration that specifies how the 
Changeable object behaves when it is "used." A Changeable object 
is considered used in the following situations: the object is set into a 
Property System property, the object is used as a sub-object in a 
complex Changeable object, or the object is used in a 
DrawingContext command. Inherited from Changeable. 

Gets the UlContext of the current object. The UlContext is used for 
maintaining thread safety. Inherited from Changeable. 

Accesses the volume of media playback. Inherited from MediaData. 

Get the video Width in pixels Inherited from MediaData. 



AudioDataConverter Class 

Definition: AudioDataConverter 



Method 

AudioDataConverter 

CanConvertFrom 

CanConvertFrom 

CanConvertTo 

CanConvertTo 

ConvertFrom 

ConvertFrom 

ConvertFromlnvariantString 

ConvertFromString 

ConvertTo 

ConvertTo 

ConvertTolnvariantString 
ConvertToString 
Createlnstance 
Equals 

Finalize 



Description 

Inherited from TypeConverter. 
CanConvertFrom 

Inherited from TypeConverter. 
TypeConverter method override. 
ConvertFromString 

Inherited from TypeConverter. 

Inherited from TypeConverter. 

Inherited from TypeConverter. 
TypeConverter method implementation. 

Inherited from TypeConverter. 

Inherited from TypeConverter. 

Inherited from TypeConverter. 

Inherited from TypeConverter. 

Determines whether two Object instances are equal. Inherited from Object. 
Allows an Object to attempt to free resources and perform other cleanup 
operations before the Object is reclaimed by garbage collection. Inherited 
from Object. 
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GetConvertFromException 

GetConvertToException 

GetCreatelnstanceSupported 

GetHashCode 

GetProperties 

GetPropertiesSupported 

GetStandardValues 

GetStandardValuesExclusive 

GetStandardValuesSupported 

GetType 

IsValid 

MemberwiseClone 

ReferenceEquals 

SortProperties 
ToString 



Inherited from TypeConverter. 
Inherited from TypeConverter. 
Inherited from TypeConverter. 

Serves as a hash function for a particular type, suitable for use in hashing 
algorithms and data structures like a hash table. Inherited from Object 
Inherited from TypeConverter. 
Inherited from TypeConverter. 
Inherited from TypeConverter. 
Inherited from TypeConverter. 
Inherited from TypeConverter. 

Gets the Type of the current instance. Inherited from Object. 
Inherited from TypeConverter. 

Creates a shallow copy of the current Object. Inherited from Object. 

Determines whether the specified Object instances are the same 
instance. Inherited from Object. 

Inherited from TypeConverter. 

Returns a String that repres ents the current Object. Inherited from Object. 



BezierSegment Class 

Definition: Represents a cubic B6zier curve drawn between two points. 



Method 

BezierSegment 

CloneCore 

CloneCore 

CloneDownToUnchangeable 
Copy 

Copy 

Copy 

DisableCore 

EmbeddedAnimationCollectionReader 

EmbeddedAnimationCollectionWriter 

EmbeddedChangeableReader 

EmbeddedChangeableWriter 

EnableCore 

Equals 
Finalize 



Description 

Initializes a new instance of the BezierSegment class. 
Returns a modifiable shallow or deep clone of the current object. 
This abstract method must be implemented by classes that derive 
from Changeable. Inherited from Changeable. 
Implementation of Animatable. CloneCore. 

Returns an immutable copy of the specified object. Inherited from 
Changeable. 

Creates a copy of this PathSegment. Inherited from PathSegment. 
Returns a modifiable copy of the current object. The copy's 
IsChangeable property is true and its StatusOfNextUse is 
Unchangeable. Inherited from Changeable. 
Creates a copy of this BezierSegment. 
Inherited from PathSegment. 

Maybe this should be internal?? Inherited from Animatable. 
Inherited from Animatable. 
Inherited from Animatable. 
Inherited from Animatable. 
Inherited from PathSegment 

Determines whether two Object instances are equal. Inherited from 
Object 

Allows an Object to attempt to free resources and perform other 
cleanup operations before the Object is reclaimed by garbage 
collection. Inherited from Object 
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GetCurrentValue 
GetCurrentValue 
GetCurrentValue 

GetHashCode 
GetType 

Makellnchangeable 

MakeUnchangeableCore 
MemberwiseClone 

ModifyHandlerlfChangeable 
OnChanged 

PropagateEventHandler 
ReadPreamble 

ReferenceEquals 

SetDefaultParentTimeline 

SetDefaultParentTimelineCore 
ToString 

ValidateObjectState 
WritePostscript 

WritePreamble 



Returns a non-animated version of this GradientStop that 
represents its current state. Inherited from PathSegment. 
Returns a non-animated version of this Animatable that represents 
its current state. Inherited from Animatable. 
Returns a non-animated version of this BezierSegment that 
represents its current state. 

Serves as a hash function for a particular type, suitable for use in 
hashing algorithms and data structures like a hash table. Inherited 
from Object. 

Gets the Type of the current instance. Inherited from Object. 
Makes an object immutable; after this method is called on a 
Changeable, its IsChangeable property is false. Inherited from 
Changeable. 

Implementation of MakeUnchangeableCore. Inherited from 
PathSegment. 

Creates a shallow copy of the current Object. Inherited from 
Object. 

Adds or removes a Changed event handler to or from the specified 
Changeable object, if the object is currently modifiable. If the 
specified object is not modifiable-if its IsChangeable property is 
false-this method has no effect. Inherited from Changeable. 
Called when the current object is modified. Classes that derive 
from Changed should call this method after they have been 
modified. Inherited from Changeable. 
Implementation of PropagateEventHandler. 
Ensures that simple (non-Changeable) membe ^re being 
accessed from a valid Ul context. This method should be called 
before any simple members are accessed. Inherited from 
Changeable. 

Determines whether the specified Object instances are the same 
instance. Inherited from Object. 

This will change the time parent for animations on any of the 
properties of this Changeable which are inheriting their time 
parent. Inherited from Animatable. 
Inherited from PathSegment. 

Returns a String that represents the current Object. Inherited from 
Object. 

Verifies that the current object has a valid state. If the object is in 
an invalid state, this method throws an exception. Inherited from 
Changeable. 

Causes the current object to validate itself and then invokes the 
OnChanged method. Inherited from Changeable. 
Ensures that simple (non-Changeable) members are being 
accessed from a valid user interface (Ul) context. This nriethod 
should be called before any simple members are set. Inherited 
from Changeable. 



Property 



Description 

Used in conjunction with the ChangeableUsageOverride type sent in 



AllowChangeableReferenceOverride as g parameter t0 ChangeableHelper.UseChangeable, to help 
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determine when a Changeable being put into "use" should be 
promoted to "ChangeableReference". Inherited from Changeable. 

True if this Changeable can be made unchangeable. Inherited from 
Changeable. 

The current parent Timeline associated with this Animatable. This 
will be the Timeline set to the ParentTimeline property of this 
Animatable if one has been set and if not, the Timeline last passed 
into the SetDefaultParentTimeline method. Inherited from 
Animatable. 

Gets a Boolean that indicates whether the segment has animations. 

Gets a Boolean that indicates whether the object is currently 
modifiable. Inherited from Changeable. 

Gets or sets a Boolean that determines whether the segment is 
stroked. Inherited from PathSegment. 

Gets or sets the first control point of the curve. 

Gets or sets a collection of PointModifier objects that animate the 
first control point of the curve. 

Gets or sets the second control point of the curve. 

Gets or sets a collection of PointModifier objects that animate the 
second control point of the curve. 

Gets or sets the end point of the curve. 

Gets or sets a collection of PointModifier objects that animate the 
end point of the curve. 

Gets or sets a UseStatus enumeration that specifies how the 
Changeable object behaves when it is "used." A Changeable object 
is considered used in the following situations: the object is set into a 
Property System property, the object is used as a sub-object in a 
complex Changeable object, or the object is used in a 
DrawingContext command. Inherited from Changeable. 
Gets the UlContext of the current object. The UlContext is used for 
maintaining thread safety. Inherited from Changeable. 

Use a PathFigure object to store BezierSegment objects and other segments. 

A cubic Bezier curve is defined by four points: a start point, an end point (Point3), and two control points 
(Pointl and Point2). The BezierSegment class does not contain a property for the starting point of the 
curve; it only defines the end point. The beginning point of the curve is the current point of the PathFigure 
to which the ArcSegment is added. 

The two control points of a cubic Bezier curve behave like magnets, attracting portions of what would 
otherwise be a straight line towards themselves, producing a curve. The first control point, Pointl, affects 
the beginning portion of the curve; the second control point, Point2, affects the ending portion of the 
curve. Note that the curve doesn't necessarily pass through either of the control points; each control point 
moves its portion of the line towards itself, but not through itself. 

This example demonstrates how to draw shapes using the Geometry, PathFigure, and PathSegment 
classes. In this example, several shapes are drawn using Geometry objects and are displayed using a 
Path element. 



CanMakeUnchangeable 

DefaultParentTimeline 

HasAnimations 
IsAnimating 

IsChangeable 

IsOverridingBaseValue 

IsStroked 

Pointl 

Pointl Animations 
Point2 

Point2Animations 
Point3 

Point3Animations 
StatusOfNextUse 
UlContext 
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There is a Geometry class for each basic geometric shape: LineGeometry, EllipseGeometry, and 
RectangleGeometry. Complex shapes, such as polygons and shapes with curved segments may be 
created using a PathGeometry. 

In the following example, a LineGeometry, EllipseGeometry, and a RectangleGeometry object are used to 
create a line, an ellipse, and a rectangle. 

IIC# 

MSAvalon. Windows. Media. LineGeometry myLineGeometry = 
new LineGeometry(new Point(50, 50), new Point(300, 50)); 

MSAvalon. Windows. Media. EllipseGeometry my EllipseGeometry = 
new EllipseGeometry(new Point(440, 100), 40, 75); 

MSAvalon. Windows. Media. RectangleGeometry myRectangleGeometry = 
new RectangleGeometry(new Rect(new Point(400, 225), new Size(100, 50))); 

'VB.NET 

Dim myLineGeometry As new MSAvalon.Windows.Media.LineGeometry( _ 

new MSAvalon. Windows. Point(50, 50), new MSAvalon. Windows. Point(300, 50)) 
Dim myEllipseGeometry As new MSAvalon. Windows.Media.EllipseGeometry( _ 

new MSAvalon. Windows. Point(440, 100), 40, 75) 
Dim myRectangleGeometry As new MSAvalon.Windows.Media.RectangleGeometry( 

new MSAvalon. Windows. Rect(new MSAvalon. Windows. Point(400,225), _ 

new MSAvalon. Windows.Size(1 00,50))) 



PathGeometry objects can be used to create complex shapes, such as arcs and curves. PathGeometry 
objects are comprised of one or more PathFigure objects; each PathFigure represents a different "figure" 
or shape. Each PathFigure is itself comprised of one or more PathSegment objects, each representing a 
connected portion of the figure or shape. Segment types include the following: LineSegment 
BezierSegment, and ArcSegment. 

In the following code, a PathGeometry and a PathFigure are created, and several segments are added to 
the PathFigure to form a shape. There are several ways to add segments to a PathFigure; you can use 
the PathFigure object's "draw segment" commands to automatically create new segments and add them 
to the figure, or you can explicitly create segments and add them manually using the PathFigure object's 
Segments property or AddSegment method. This example shows both ways of adding seqments to a 
figure. 

The first segment of a PathFigure must be a StartSegment. The StartSegment may be added by creating 
a new StartSegment and adding it to the PathFigure, or it can be added using the PathFigure object's 
StartAt method. The following code demonstrates adding a StartSegment using the StartAt method The 
start point is set to (200,50). 

//C# 

MSAvalon. Windows. Media. PathGeometry myPathGeometry = new PathGeometryQ; 
MSAvalon.Windows. Media. PathFigure myPathFigure = new PathFigure(); 

// PathFigure objects must have a defined start point before 
// other segments can be added. 
myPathFigure.StartAt(new Point(200,50)); 

'VB.NET 

Dim myPathGeometry As new MSAvalon.Windows.Media.PathGeometry() 
Dim myPathFigure As new MSAvalon.Windows.Media.PathFigureQ 
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' PathFigure objects must have a defined start point before 
' other segments can be added. 

myPathFigure.StartAt(new MSAvalon.Windows.Point(200,50)) 

In the following code, the BezierTo method is used to create three B6zier curves. A fourth curve is 
created by explicitly creating a BezierSegment and adding it to myPathFigure using the AddSegment 
method. After the segments are added to the PathFigure (myPathFigure), the PathFigure is added to the 
PathGeometry. 

//C# 

myPathFigure.BezierTo( 

new Point(400, 100), new Point(400, 200), new Point(200, 300)); 

myPathFigure.BezierTo( 
new Point(400, 300), new Point(400, 100), new Point(200, 50)); 

myPathFigure. BezierTo( 

new Point(0, 100), new Point(0, 200), new Point(200,300)); 

MSAvalon.Windows.Media. BezierSegment myBezierSegment = 
new BezierSegment(new Point(0, 300), new Point(0, 100), new Point(200, 50), true); 

myPathFigure.AddSegment(myBezierSegment); 

myPathGeometry.Figures.Add(myPathFigure); 

* VB.NET 

myPathFigure. BezierTo(new MSAvalon.Windows.Point(400, 100), _ 
new MSAvalon. Windows. Point(400, 200), new MSAvalon. Windows. Point(200, 300)) 

myPathFigure.BezierTo(new MSAvalon.Windows.Point(400, 300), _ 
new MSAvalon. Windows. Point(400, 100), new MSAvalon. Windows. Point(200, 50)) 

myPathFigure. BezierTo(new MSA valon. Windows. Point(0, 100), _ 
new MSAvalon. Windows. Point(0, 200), new MSAvalon.Windows.Point(200,300)) 

Dim myBezierSegment As new BezierSegment( _ 
new MSAvalon.Windows.Point(0, 300), new MSAvalon.Windows.Point(0, 100), _ 
new MSAvalon. Windows. Point(200, 50), true) 

myPathFigure.AddSegment(myBezierSegment) 

' Add the PathFigure to the PathGeometry 
myPathGeometry.Figures.Add(myPathFigure) 

In the final code example, the geometries are added to a GeometryCollection, and the 
GeometryCollection is used to set the Path element's Data property. Had there been only one geometry, 
it could have been used to set the Data property directly, without the GeometryCollection. 

//C# 

GeometryCollection myGeometryCollection = new GeometryCollection(); 

myGeometryCollection.Add(myLineGeometry); 

myGeometryCollection.Add(myEllipseGeometry); 

myGeometryCollection.Add(myRectangleGeometry); 

myGeometryCollection.Add(myPathGeometry); 
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Path myPath = new Path(); 
myPath.Data = myGeometryCollection; 

// Set the outline and the fill of the Path element. 

myPath.Stroke = Brushes. Blue; 

myPath.StrokeThickness = new Length(5); 

SolidColorBrush solidFill = new SolidColorBrush(); 

myPath.Fill = new Radia!GradientBnjsh(Colors.Orange, Colors.Red); 

// Add the Path element to a Canvas. 
myCanvas.Children.Add(myPath); 

•VB.NET 

Dim myGeometryCollection As new MSAvalon.Windows.Media.GeometryCollection() 

myGeometryCollection.Add(myLineGeometry) 

myGeometryCollection. Add(myEllipseGeometry) 

myGeometryCollection.Add(myRectangleGeometry) 

myGeometryCollection.Add(myPathGeometry) 

Dim myPath As new Path() 
myPath.Data = myGeometryCollection 

1 Set the outline and the fill of the Path element. 
myPath.Stroke = MSAvalon.Windows.Media.Brushes.Blue 
myPath.StrokeThickness = new MSAvalon.Windows.Length(5) 
Dim solidFill As new MSAvalon.Windows.Media.SolidColorBrush() 
myPath.Fill = new RadialGradientBrush(MSAvalon.Windows.Media.Colors.Orange, _ 
MSAvalon.Windows.Media. Colors. Red) 

' Add the Path element to a Canvas. 
myCanvas.Children.Add(myPath) 

Geometry objects may also be rendered using the DrawingContext, which supplies a DrawGeometry 
method that may be used to render Geometry objects. Geometry objects may also be used for clipping 
and hit-testing. 



Brush Class 

Definition: Provides a generic means for filling an area using solid colors (SolidColorBrush), gradients 
(LinearGradientBrush, RadialGradientBrush), images (ImageBrush), video, and more. 

Method Description 

Brush Initializes a new instance of the Brush class. 

Returns a modifiable shallow or deep clone of the current 
CloneCore object. This abstract method must be implemented by 

classes that derive from Changeable. Inherited from 
Changeable. 
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CloneCore 



CloneDownToUnchangeable 



Copy 



Copy 

DeserializeFrom 
DisableCore 

EmbeddedAnimationCollectionReader 

EmbeddedAnimationCollectionWriter 

EmbeddedChangeableReader 

EmbeddedChangeableWriter 

EnableCore 

Equals 

Finalize 



GetCurrentValue 

GetCurrentValue 
GetHasAnimations 

GetHashCode 

GetlsAnimating 

GetlsOverridingBaseValue 

GetType 

MakeUnchangeable 

MakeUnchangeableCore 
MemberwiseClone 

ModifyHandlerlfChangeable 
OnChanged 



Subclasses must implement this to provide clones of 
themselves. Inherited from Animatable. 

Returns an immutable copy of the specified object. Inherited 
from Changeable. 

Returns a modifiable copy of the brush. The copy's 
IsChangeable property is true and its StatusOfNextUse is 
Unchangeable. 

Returns a modifiable copy of the current object. The copy's 
IsChangeable property is true and its StatusOfNextUse is 
Unchangeable. Inherited from Changeable. 

Returns a new Brush initialized from the binary 
representation being read by the passed BinaryReader. 

Maybe this should be internal?? Inherited from Animatable. 
Inherited from Animatable. 
Inherited from Animatable. 
Inherited from Animatable. 

Determines whether two Object instances are 
equal. Inherited from Object. 

Returns the current value of the brush. The returned brush 
has the same value as the current object, but doesn't vary 
over time; that is, the returned brush is a snapshot of the 
current object at the point in time at which this method was 
called. 

Returns a non-animated version of this Animatable that 
represents its current state. Inherited from Animatable. 

Serves as a hash function for a particular type, suitable for 
use in hashing algorithms and data structures like a hash 
table. Inherited from Object- 



Gets the Type of the current instance. Inherited from Object. 
Makes an object immutable; after this method is called on a 
Changeable, its IsChangeable property is false. Inherited 
from Changeable. 

Implementation of MakeUnchangeableCore. 

Creates a shallow copy of the current Object. Inherited from 
Object. 

Adds or removes a Changed event handler to or from the 
specified Changeable object, if the object is currently 
modifiable. If the specified object is not modifiable — if its 
IsChangeable property is false— this method has no 
effect. Inherited from Changeable. 

Called when the current object is modified. Classes that 
derive from Changed should call this method after they have 
been modified. Inherited from Changeable. 
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PropagateEventHandler 
ReadPreamble 

ReferenceEquals 
SerializeOn 

SetDefaultParentTimeline 

SetDefaultParentTimeline 

SetDefaultParentTimelineCore 
ToString 

ValidateObjectState 
WritePostscript 

WritePreamble 



Ensures that simple (non-Changeable) members are being 
accessed from a valid Ul context. This method should be 
called before any simple members are accessed. Inherited 
from Changeable. 

Determines whether the specified Object instances are the 
same instance. Inherited from Object. 

Serialize this object using the passed writer 

This will change the time parent for animations on any of the 
properties of this Changeable which are inheriting their time 
parent. Inherited from Animatable. 

Returns a String that represents the current Object. Inherited 
from Object. 

Verifies that the current object has a valid state. If the object 
is in an invalid state, this method throws an 
exception. Inherited from Changeable. 

Causes the current object to validate itself and then invokes 
the OnChanged method. Inherited from Changeable. 

Ensures that simple (non-Changeable) members are being 
accessed from a valid user interface (Ul) context. This 
method should be called before any simple members are 
set. Inherited from Changeable. 



Property 

AllowChangeableReferenceOverride 

CanMakeUnchangeable 

DefaultParentTimeline 

HasAnimations 
IsAnimating 

IsChangeable 

IsOverridingBaseValue 
Opacity 

OpacityAnimations 
StatusOfNextUse 



Description 

Used in conjunction with the ChangeableUsageOverride type sent in 
as a parameter to ChangeableHelper.UseChangeable, to help 
determine when a Changeable being put into "use" should be 
promoted to "ChangeableReference". Inherited from Changeable. 

True if this Changeable can be made unchangeable. Inherited from 
Changeable. 

The current parent Timeline associated with this Animatable. This 
will be the Timeline set to the ParentTimeline property of this 
Animatable if one has been set and if not, the Timeline last passed 
into the SetDefaultParentTimeline method. Inherited from 
Animatable. 

Gets a Boolean that indicates whether the brush has animations. 

Gets a Boolean that indicates whether the object is currently 
modifiable. Inherited from Changeable. 

Gets or sets the degree of opacity of a Brush. 

Gets or sets the animations associated with the Opacity of the 
brush. 

Gets or sets a UseStatus enumeration that specifies how the 
Changeable object behaves when it is "used." A Changeable object 
is considered used in the following situations: the object is set into a 
Property System property, the object is used as a sub-object in a 
complex Changeable object, or the object is used in a 
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DrawingContext command. Inherited from Changeable. 
Gets or sets a transformation that is applied to the brush. This 
Transform transformation is applied after all other mapping and positioning 

have been processed. 

UlContext Gets the UIContex t o f the current object. The UlContext is used for 

maintaining thread safety. Inherited from Changeable. 

Use the Brushes class to fill an object using a predefined solid color, such as AliceBlue. 
A quick way to use a Brush in "Longhorn" markup language (code-named "XAML") is to supply the string 
for a color name from the Colors class, such as "Red" for the Red property or "ForestGreen" for the 
ForestGreen property. Hexadecimal notation is also valid. 

This example creates simple vertical, horizontal, and radial gradients and uses them to fill an element 
using "XAML". 

In the following example, vertical and horizontal gradients are used to set the Fill property of two 
Rectangle elements. In this particular example, the gradients are described using simple notation: 
GradientType StartColor EndColor, where GradientType is VerticalGradient, HorizontalGradient, or 
RadialGradient. StartColor and EndColor can be predefined color names (such as Blue) or hexadecimal 
values. 

<Canvas xmlns="http.7/schemas. microsoft.com/2003/xaml"> 
<Rectangle 

Fill="VerticalGradient Blue Green" 
RectangleLeft="20" 
RectangleTop="20" 
RectangleWidth="100" 
RectangleHeight="100"> 
</Rectangle> 

<Rectangle 

Fill="HorizontalGradient Blue Red" 

RectangleLeft="120" 

RectangleTop="120" 

RectangleWidth="100" 

RectangleHeight="100"> 
</Rectangle> 

A vertical gradient is a linear gradient whose start and endpoints form a vertical line; likewise, a horizontal 
gradient is a linear gradient whose start and endpoints form a horizontal line. You can explicitly describe 
your own linear gradients using the following syntax: 

LinearGradient StartPoint EndPoint StartColor EndColor, where StartPoint and EndPoint are the starting 
and ending coordinates, with each coordinate expressed as a pair of x and y values from 0 to 1, such as 
0.1,0.1 and 0.5,0.5. These values indicate the relative position of the start or end point. An endpoint of 
0.5,0.5 would be located 50 percent to the right of the fill area and 50 percent of the way from the top of 
the area— the middle of the shape. 

In the following example, the Fill property of a Rectangle element is set by explicitly using a linear 
gradient. 

<Rectangle 

Fill="LinearGradient 0.1,0.1 0.5,0.5 Blue Green" 

RectangleLeft="220" 

RectangleTop="220" 
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RectangleWidth="100" 
RectangieHeight="100"> 
</Rectangle> 

In the final example, the Fill property of a Rectangle element is set using a radial gradient. 

<Rectangle 

Fill="RadialGradient Blue Red" 

RectangleLeft= M 320" 

RectangleTop="320 M 

RectangleWidth= n 100 M 

RectangleHeight="1 00"> 
</Rectangle> 

</Canvas> 

To create vertical and horizontal gradients in code or using compound notation, use the 
LinearGradientBrush class and set its StartPoint and EndPoint properties so that they describe a vertical 
or horizontal line. To create radial gradients in code or using compound notation use the 
RadialGradientBrush class. 

This example uses the SolidColorBrush class in "XAML" to color areas such as the window background 
and the border and interior of shapes. The SolidColorBrush creates fills that are uniform in color— it can't 
create gradient or pattern fills. SolidColorBrush uses both predefined color values and hexadecimal color 
values. In this example, several Ellipse shapes are created with identical fills and outlines but the fills and 
outlines are specified in different formats to demonstrate the versatility of the SolidColorBrush class 
In the following markup, a Canvas element is declared and its Background property is set to LiqhtGrav 
one of the predefined colors. " 7 ' 

<Canvas ID= M root" xmlns= n http://schemas.microsoft.com/2003/xaml" 
Background="LightGray"> 

In the next example, the Fill and Stroke properties of an Ellipse are set using ARGB notation ARGB 
consists of a pound sign (#) and eight digits. The pound sign indicates that the digits that follow are in 
hexidecimal (base-16) format. The first two digits specify the alpha value, or opacity of the color FF 
indicates a color that is fully opaque, while 00 indicates a color that is completely transparent The next 
six digits of the number specify the red, green, and blue values of the color. 
The fill of the Ellipse is set to #FFFFFF00, which specifies a color that is fully opaque (FF), has the 
maximum amount of red (FF), the maximum amount of green (FF), and no blue(OO). This combination 
produces yellow. 

<Ellipse 
Fill="#FFFFFF00 M 
CenterX="100" 
CenterY= ,, 200" 
RadiusX= n 75" 
RadiusY="75" 
StrokeThickness= M 5" 
Stroke="#FF0000FF7> 

In the next example, the Fill and Stroke properties of an Ellipse are set using shorter hexidecimal 
notation. The alpha value is omitted, and one digit is used for each red, green, and blue value instead of 
two. The resulting Ellipse has colors identical to the first. 

<Ellipse 
Fil!="#FF0" 
CenterX="200" 
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CenterY="200" 

RadiusX= M 75" 

RadiusY="75" 

StrokeThickness= H 5 M 

Stroke= ,, #00F , 7> 

In the next example, the Fill and Stroke properties of an Ellipse are set using two of the predefined colors 
Yellow and Blue. The resulting Ellipse has colors identical to the previous two. 

<Ellipse 
Fill^'Yellow" 
CenterX="300" 
CenterY="200" 
RadiusX="75" 
RadiusY= u 75 M 
StrokeThickness= n 5" 
Stroke="Blue7> 

In the final example, the Fill property of a Polyline is set by explicitly declaring a SolidColorBrush. The 
Color property of the SolidColorBrush is set to Blue, and its Opacity property is set to 0.4, creating a fill 
that is blue and 40 percent opaque (or 60 percent translucent). 

<Polyline 

Points= M 300,200 400,125 400,275 300,200" 

Stroke="Purple M 

StrokeThickness="2.3 M > 

<Polyline.Fill> 

<SolidColorBrush Color= M Blue" Opacity="0.47> 
</Polyline.Fill> 

</Polyline> 

</Canvas> 

This example demonstrates several equivalent ways to specify color values to fill an area using code The 
simplest syntax uses a named color property from the Brushes class. The Colors class provides the same 
named color properties which you can pass as an argument to SolidColorBrush. The example also shows 
how to pass Color values to SolidColorBrush as separate alpha, red, green, and blue values using the 
Color structure's static FromScRGB method. The example draws identical Ellipse shapes using identical 
colors specified in these different ways. 

II C# 

II Create the ellipses. 
Ellipse e1 = new Ellipse(); 
Ellipse e2 = new Ellipse(); 
Ellipse e3 = new Ellipse(); 

// Set the fill value for the interior of each ellipse in 

// different ways that have identical results. 

el.Fill = Brushes.Blue; 

e2.Fill = new SolidColorBrush(Colors.Blue); 

e3.Fill = new SolidColorBrush(Color.FromScRGB(1,0,0,1)); 

// Set the stroke value for the interior of each ellipse in 
// different ways that have identical results. 
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e1. Stroke = Brushes. Black; 

e2.Stroke = new SolidColorBrush(Colors. Black); 

e3.Stroke = new SoIidColorBrush(Color.FromScRGB(1, 0,0,0)); 



This sample demonstrates only a few of the ways to instantiate Color objects. See Color for more 
information. 

In order to actually render the ellipse the example also sets values for the StrokeThickness, CenterX 
CenterY, RadiusX, and RadiusY properties in order to set the size and position of each ellipse. 

//C# 

// Set the thickness of the stroke. 
e1. StrokeThickness = new Length(10) 
e2.StrokeThickness = new Length(10) 
e3. StrokeThickness = new Length(10) 

// Set the size and position of the ellipses. 
e1 .CenterX = new Length(100); 
el.CenterY = new Length(75); 
e1. RadiusX = new Length(50); 
e1. RadiusY = new Length(50); 

e2.CenterX = new Length(220); 
e2.CenterY = new Length(75); 
e2. RadiusX = new Length(50); 
e2. RadiusY = new Length(50); 

e3.CenterX = new Length(340); 
e3.CenterY = new Length(75); 
e3. RadiusX = new Length(50); 
e3. RadiusY = new Length(50); 

This example demonstrates how to make an element transparent or semi-transparent using the 
UlElementOpacity and the Opacity property of Brush objects. The value of opacity properties is 
expressed as a value between 0 and 1, specifying a continuous range from fully transparent to fully 
opaque. A value of 0 specifies that the element is completely transparent while a value of 1 makes the 
element completely opaque. There are several ways of making an element transparent or semi- 
transparent; if the element has a background or a stroke property, you can set the Opacity property of the 
Brush associated with the stroke or background. Alternately, you can set the UlElementOpacity property 
of the element, which affects the entire element and all its children 

In this example, three Ellipse elements, ellipses A, B, and C, are drawn in a Canvas and are made 
partially transparent. Ellipse A's UlElementOpacity property is set to 0.5, making the entire element 
appear 50 percent opaque. Ellipse B's Fill is set explicitly using a SolidColorBrush. The SolidColorBrush 
objects Opacity property is set to 0.5. The resulting shape has a fully opaque Stroke and a 50 percent 
opaque Fill. Ellipse C has both its UlElementOpacity property and the Opacity property of its 
SolidColorBrush set to 0.5, resulting in a shape with a 50 percent opaque Stroke and a 25 percent 
opaque Fill (0.5 multiplied by 0.5). 

<Canvas xmlns="http://schemas.microsoft.com/2003/xaml M 
Width="100%" Height="100%"> 

<!-- Omitted Code: A line is drawn behind the ellipses 

and a fully opaque Ellipse is drawn for visual comparison.-> 

<Ellipse 
ID-TV' 
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Fill="Red" 

Stroke="Black" 

StrokeThickness="10" 

CenterX="140" 

CenterY="150" 

RadiusX="25" 

RadiusY="100" 

UIEIement.Opacity="0.57> 

<Text Canvas. Left=" 125" Canvas.Top="270" FontSize="20">A<n"ext> 

< Ellipse 
ID="B" 

Stroke="Black" 

StrokeThickness="10" 

CenterX="210" 

CenterY="150" 

RadiusX="25" 

RadiusY="100"> 

<Shape.Fill> 

<SolidColorBrush Color="Red" Opacity="0.57> 
</Shape.Fill> 
</Ellipse> 

<Text Canvas.Left="185" Canvas.Top="270" FontSize="20">B<AText> 

<Ellipse 
ID="C" 

Stroke="Black" 
StrokeThickness="10" 
CenterX="280" 
CenterY="150" 
RadiusX="25" 
RadiusY="100" 
UIEIement.Opacity="0.5"> 
<Shape.Fill> 
<SolidColorBrush Color="Red" Opacity="0.5"/> 
</Shape.Fill> 
</Ellipse> 

<Text Canvas. Left="255" Canvas.Top="270" FontSize="20">C</Text> 
</Canvas> 

This example demonstrates how to create a gradient that has more than two colors in "XAML". To create 
a gradient with more than two colors, add a GradientStopCollection to the gradient's GradientStops 
property. Next, add GradientStop objects to the GradientStopCollection, one for each color the gradient 
should contain. Set the Color and the Offset, a value from 0 to 1 that determines the relative position of 
the stop in the gradient, of each of the stops. The following example shows a Button whose Background 
is filled with a horizontal gradient that has four colors. 

<Canvas ID="root" 

xmlns="http://schemas.microsoft.com/2003/xaml"> 
< Button 

Canvas.Top="50" 
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Canvas.Left= n 50" 
BorderBrush="Black" 
Width="200 M 
Height= M 30"> 
<Button.Background> 
<LinearGradientBrush > 
<LinearGradientBrush.GradientStops> 
<GradientStopCollection> 
<GradientStop Color="Red" Offset="0 M /> 
<GradientStop Color="Blue" Offset="0.257> 
<GradientStop Color="Orange" Offset= ,, 0.75 , 7> 
<GradientStop Color= M Yellow" Offset="17> 
</GradientStopCollection> 
</LinearGradientBrush.GradientStops> 
</LinearGradientBrush> 
</Button.Background> 
</Button> 

</Canvas> 



BrushConverter Class 

Definition: Used to convert a Brush object to or from another object type. 



Method 

BrushConverter 

CanConvertFrom 

CanConvertFrom 
CanConvertTo 

CanConvertTo 

ConvertFrom 
ConvertFrom 

ConvertFromlnvariantString 

ConvertFromString 

ConvertTo 

ConvertTo 

ConvertTol n variantString 

ConvertToString 

Createlnstance 

Equals 
Finalize 

GetConvertFromException 

GetConvertToException 

GetCreatelnstanceSupported 



Description 

Initializes a new instance of the BrushConverter class. 

Determines whether this class can convert an object of a given type to a 
Brush object. 

Inherited from TypeConverter. 
Inherited from TypeConverter. 

Determines whether this class can convert an object of a given type to 
the specified destination type. 
Inherited from TypeConverter. 

Converts from an object of a given type to a Brush object. 
Inherited from TypeConverter. 
Inherited from TypeConverter. 
Inherited from TypeConverter. 

Converts a Brush object to a specified type, using the specified context 
and culture information. 

Inherited from TypeConverter. 

Inherited from TypeConverter. 

Inherited from TypeConverter. 

Determines whether two Object instances are equal. Inherited from 
Object. 

Allows an Object to attempt to free resources and perform other cleanup 
operations before the Object is reclaimed by garbage collection. Inherited 
from Object. 

Inherited from TypeConverter. 
Inherited from TypeConverter. 
Inherited from TypeConverter. 
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GetHashCode Serves as a hash function for a particular type, suitable for use in hashing 

algorithms and data structures like a hash table. Inherited from Object. 
GetProperties Inherited from TypeConverter. 

GetPropertiesSupported Inherited from TypeConverter. 
GetStandardValues Inherited from TypeConverter. 

GetStandardValuesExclusive Inherited from TypeConverter. 
GetStandardValuesSupported Inherited from TypeConverter. 

GetType Gets the Type of the current instance. Inherited from Object 

IsValid Inherited from TypeConverter. 

MemberwiseClone Creates a shallow copy of the current Object. Inherited from Object. 

ReferenceEquals Determines whether the specified Object instances are the same 

instance. Inherited from Object. 
SortProperties Inherited from TypeConverter. 

ToString Returns a String that represents the current Object. Inherited from Object. 



Brushes Class 

Definition: Implements a set of predefined solid colors. 

Description 

Determines whether two Object instances are equal. Inherited from Object. 
Allows an Object to attempt to free resources and perform other cleanup operations 
before the Object is reclaimed by garbage collection. Inherited from Object. 
Serves as a hash function for a particular type, suitable for use in hashing algorithms 
and data structures like a hash table. Inherited from Object. 
Gets the Type of the current instance. Inherited from Object. 
Creates a shallow copy of the current Object. Inherited from Object. 

Determines whether the specified Object instances are the same instance. Inherited 
from Object. 

Returns a String that represents the current Object. Inherited from Object. 



Property Description 

AliceBlue Gets the solid fill color that has a hexadecimal value of #FFF0F8FF. 

AntiqueWhite Gets the solid fill color that has a hexadecimal value of #FFFAEBD7. 

Aqua Gets the solid fill color that has a hexadecimal value of #FF00FFFF. 

Aquamarine Gets the solid fill color that has a hexadecimal value of #FF7FFFD4. 

Azure Gets the solid fill color that has a hexadecimal value of #FFF0FFFF. 

Bei ge Gets the solid fill color that has a hexadecimal value of #FFF5F5DC. 

B *sque Gets the solid fill color that has a hexadecimal value of #FFFFE4C4. 

Black Gets the solid fill color that has a hexadecimal value of #FF000000. 

BlanchedAlmond Gets the solid fill color that has a hexadecimal value of #FFFFEBCD. 

B| ue Gets the solid fill color that has a hexadecimal value of #FF0000FF. 

BlueViolet Gets the solid fill color that has a hexadecimal value of #FF8A2BE2. 

Brown Gets the solid fill color that has a hexadecimal value of #FFA52A2A. 

BurlyWood Gets the solid fill color that has a hexadecimal value of #FFDEB887. 

CadetBlue Gets the solid fill color that has a hexadecimal value of #FF5F9EA0. 



Method 

Equals 

Finalize 

GetHashCode 
GetType 

MemberwiseClone 
ReferenceEquals 

ToString 
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Chartreuse 

Chocolate 

Coral 

CornflowerBlue 

Cornsilk 

Crimson 

Cyan 

DarkBlue 

DarkCyan 

DarkGoldenrod 

DarkGray 

DarkGreen 

DarkKhaki 

DarkMagenta 

DarkOliveGreen 

DarkOrange 

DarkOrchid 

DarkRed 

DarkSalmon 

DarkSeaGreen 

OarkSlateBlue 

DarkSlateGray 

DarkTurquoise 

DarkViolet 

DeepPink 

DeepSkyBlue 

DimGray 

DodgerBlue 

Firebrick 

FloralWhite 

ForestGreen 

Fuchsia 

Gainsboro 

GhostWhite 

Gold 

Goldenrod 

Gray 

Green 

GreenYellow 

Honeydew 

HotPink 

IndianRed 

Indigo 

Ivory 



Gets the solid fill color that has a hexadecimal value of #FF7FFF00. 
Gets the solid fill color that has a hexadecimal value of #FFD2691E. 
Gets the solid fill color that has a hexadecimal value of #FFFF7F50. 
Gets the solid fill color that has a hexadecimal value of #FF6495ED. 
Gets the solid fill color that has a hexadecimal value of #FFFFF8DC. 
Gets the solid fill color that has a hexadecimal value of #FFDC143C. 
Gets the solid fill color that has a hexadecimal value of #FF00FFFF. 
Gets the solid fill color that has a hexadecimal value of #FF00008B. 
Gets the solid fill color that has a hexadecimal value of #FF008B8B. 
Gets the solid fill color that has a hexadecimal value of #FFB8860B. 
Gets the solid fill color that has a hexadecimal value of #FFA9A9A9. 
Gets the solid fill color that has a hexadecimal value of #FF006400. 
Gets the solid fill color that has a hexadecimal value of #FFBDB76B. 
Gets the solid fill color that has a hexadecimal value of #FF8B008B. 
Gets the solid fill color that has a hexadecimal value of #FF556B2F. 
Gets the solid fill color that has a hexadecimal value of #FFFF8C00. 
Gets the solid fill color that has a hexadecimal value of #FF9932CC. 
Gets the solid fill color that has a hexadecimal value of #FF8B0000. 
Gets the solid fill color that has a hexadecimal value of #FFE9967A. 
Gets the solid fill color that has a hexadecimal value of #FF8FBC8B. 
Gets the solid fill color that has a hexadecimal value of #FF483D8B. 
Gets the solid fill color that has a hexadecimal value of #FF2F4F4F. 
Gets the solid fill color that has a hexadecimal value of #FF00CED1 . 
Gets the solid fill color that has a hexadecimal value of #FF9400D3. 
Gets the solid fill color that has a hexadecimal value of #FFFF1493. 
Gets the solid fill color that has a hexadecimal value of #FF00BFFF. 
Gets the solid fill color that has a hexadecimal value of #FF696969. 
Gets the solid fill color that has a hexadecimal value of #FF1 E90FF. 
Gets the solid fill color that has a hexadecimal value of #FFB22222. 
Gets the solid fill color that has a hexadecimal value of #FFFFFAF0. 
Gets the solid fill color that has a hexadecimal value of #FF228B22. 
Gets the solid fill color that has a hexadecimal value of #FFFF00FF. 
Gets the solid fill color that has a hexadecimal value of #FFDCDCDC. 
Gets the solid fill color that has a hexadecimal value of #FFF8F8FF. 
Gets the solid fill color that has a hexadecimal value of #FFFFD700. 
Gets the solid fill color that has a hexadecimal value of #FFDAA520. 
Gets the solid fill color that has a hexadecimal value of #FF808080. 
Gets the solid fill color that has a hexadecimal value of #FF008000. 
Gets the solid fill color that has a hexadecimal value of #FFADFF2F. 
Gets the solid fill color that has a hexadecimal value of #FFF0FFF0. 
Gets the solid fill color that has a hexadecimal value of #FFFF69B4. 
Gets the solid fill color that has a hexadecimal value of #FFCD5C5C. 
Gets the solid fill color that has a hexadecimal value of #FF4B0082. 
Gets the solid fill color that has a hexadecimal value of #FFFFFFF0. 
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Khaki 

Lavender 

LavenderBlush 

LawnGreen 

LemonChiffon 

LightBlue 

LightCoral 

LightCyan 

LightGoldenrodYellow 

LightGray 

LightGreen 

LightPink 

LightSalmon 

LightSeaGreen 

LightSkyBlue 

LightSlateGray 

LightSteelBlue 

LightYellow 

Lime 

LimeGreen 
Linen 
Magenta 
Maroon 

MediumAquamarine 

MediumBlue 

MediumOrchid 

MediumPurple 

MediumSeaGreen 

MediumSlateBlue 

MediumSpringGreen 

MediumTurquoise 

MediumVioletRed 

MidnightBlue 

MintCream 

MistyRose 

Moccasin 

NavajoWhite 

Navy 

OldLace 

Olive 

OliveDrab 

Orange 

OrangeRed 

Orchid 



Gets the solid fill color that has a 
Gets the solid fill color that has a 
Gets the solid fill color that has a 
Gets the solid fill color that has a 
Gets the solid fill color that has a 
Gets the solid fill color that has a 
Gets the solid fill color that has a 
Gets the solid fill color that has a 
Gets the solid fill color that has a 
Gets the solid fill color that has a 
Gets the solid fill color that has a 
Gets the solid fill color that has a 
Gets the solid fill color that has a 
Gets the solid fill color that has a 
Gets the solid fill color that has a 
Gets the solid fill color that has a 
Gets the solid fill color that has a 
Gets the solid fill color that has a 
Gets the solid fill color that has a 
Gets the solid fill color that has a 
Gets the solid fill color that has a 
Gets the solid fill color that has a 
Gets the solid fill color that has a 
Gets the solid fill color that has a 
Gets the solid fill color that has a 
Gets the solid fill color that has a 
Gets the solid fill color that has a 
Gets the solid fill color that has a 
Gets the solid fill color that has a 
Gets the solid fill color that has a 
Gets the solid fill color that has a 
Gets the solid fill color that has a 
Gets the solid fill color that has a 
Gets the solid fill color that has a 
Gets the solid fill color that has a 
Gets the solid fill color that has a 
Gets the solid fill color that has a 
Gets the solid fill color that has a 
Gets the solid fill color that has a 
Gets the solid fill color that has a 
Gets the solid fill color that has a 
Gets the solid fill color that has a 
Gets the solid fill color that has a 
Gets the solid fill color that has a 



hexadecimal value of #FFF0E68C. 
hexadecimal value of #FFE6E6FA. 
hexadecimal value of #FFFFF0F5. 
hexadecimal value of #FF7CFC00. 
hexadecimal value of #FFFFFACD. 
hexadecimal value of #FFADD8E6. 
hexadecimal value of #FFF08080. 
hexadecimal value of #FFE0FFFF. 
hexadecimal value of #FFFAFAD2. 
hexadecimal value of #FFD3D3D3. 
hexadecimal value of #FF90EE90. 
hexadecimal value of #FFFFB6C1. 
hexadecimal value of #FFFFA07A. 
hexadecimal value of #FF20B2AA. 
hexadecimal value of #FF87CEFA. 
hexadecimal value of #FF778899. 
hexadecimal value of #FFB0C4DE. 
hexadecimal value of #FFFFFFE0. 
hexadecimal value of #FF00FF00. 
hexadecimal value of #FF32CD32. 
hexadecimal value of #FFFAF0E6. 
hexadecimal value of #FFFF00FF. 
hexadecimal value of #FF800000. 
hexadecimal value of #FF66CDAA. 
hexadecimal value of #FF0000CD. 
hexadecimal value of #FFBA55D3. 
hexadecimal value of #FF9370DB. 
hexadecimal value of #FF3CB371. 
hexadecimal value of #FF7B68EE. 
hexadecimal value of #FF00FA9A. 
hexadecimal value of #FF48D1CC. 
hexadecimal value of #FFC71585. 
hexadecimal value of #FF191970. 
hexadecimal value of #FFF5FFFA. 
hexadecimal value of #FFFFE4E1. 
hexadecimal value of #FFFFE4B5. 
hexadecimal value of #FFFFDEAD. 
hexadecimal value of #FF000080. 
hexadecimal value of #FFFDF5E6. 
hexadecimal value of #FF808000. 
hexadecimal value of #FF6B8E23. 
hexadecimal value of #FFFFA500. 
hexadecimal value of #FFFF4500. 
hexadecimal value of #FFDA70D6. 
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PaleGoidenrod Gets the solid fill color that has a hexadecimal value of #FFEEE8AA. 

PaleGreen Gets the solid fill color that has a hexadecimal value of #FF98FB98. 

PaleTurquoise Gets the solid fill color that has a hexadecimal value of #FFAFEEEE. 

PaleVioletRed Gets the solid fill color that has a hexadecimal value of #FFDB7093. 

PapayaWhip Gets the solid fill color that has a hexadecimal value of #FFFFEFD5. 

Peach Puff Gets the solid fill color that has a hexadecimal value of #FFFFDAB9. 

Peru Gets the solid fill color that has a hexadecimal value of #FFCD853F. 

Pink Gets the solid fill color that has a hexadecimal value of #FFFFC0CB. 

Plum Gets the solid fill color that has a hexadecimal value of #FFDDA0DD. 

PowderBlue Gets the solid fill color that has a hexadecimal value of #FFB0E0E6. 

Purple Gets the solid fill color that has a hexadecimal value of #FF800080. 

Red Gets the solid fill color that has a hexadecimal value of #FFFF0000. 

RosyBrown Gets the solid fill color that has a hexadecimal value of #FFBC8F8F. 

RoyalBlue Gets the solid fill color that has a hexadecimal value of #FF4169E1. 

SaddleBrown Gets the solid fill color that has a hexadecimal value of #FF8B451 3. 

Salmon Gets the solid fill color that has a hexadecimal value of #FFFA8072. 

SandyBrown Gets the solid fill color that has a hexadecimal value of #FFF4A460. 

SeaGreen Gets the solid fill color that has a hexadecimal value of #FF2E8B57. 

SeaShell Gets the solid fill color that has a hexadecimal value of #FFFFF5EE. 

Sienna Gets the solid fill color that has a hexadecimal value of #FFA0522D. 

Silver Gets the solid fill color that has a hexadecimal value of #FFC0C0C0. 

SkyBlue Gets the solid fill color that has a hexadecimal value of #FF87CEEB. 

SlateBlue Gets the solid fill color that has a hexadecimal value of #FF6A5ACD. 

SlateGray Gets the solid fill color that has a hexadecimal value of #FF708090. 

Snow Gets the solid fill color that has a hexadecimal value of #FFFFFAFA. 

SpringGreen Gets the solid fill color that has a hexadecimal value of #FF00FF7F. 

SteelBlue Gets the solid fill color that has a hexadecimal value of #FF4682B4. 

Tan Gets the solid fill color that has a hexadecimal value of #FFD2B48C. 

Teal Gets the solid fill color that has a hexadecimal value of #FF008080. 

Thistle Gets the solid fill color that has a hexadecimal value of #FFD8BFD8. 

Tomato Gets the solid fill color that has a hexadecimal value of #FFFF6347. 

Transparent Gets the solid fill color that has a hexadecimal value of #00FFFFFF. 

Turquoise Gets the solid fill color that has a hexadecimal value of #FF40E0D0. 

Violet Gets the solid fill color that has a hexadecimal value of #FFEE82EE. 

Wheat Gets the solid fill color that has a hexadecimal value of #FFF5DEB3. 

White Gets the solid fill color that has a hexadecimal value of #FFFFFFFF. 

WhiteSmoke Gets the solid fill color that has a hexadecimal value of #FFF5F5F5. 

Yellow Gets the solid fill color that has a hexadecimal value of #FFFFFF00. 

YellowGreen Gets the solid fill color that has a hexadecimal value of #FF9ACD32. 



The "Avalon" color names match the Microsoft® .NET Framework version 1.0, Windows Forms, and 
Microsoft Internet Explorer color names. This representation is based on Unix X11 named color values. 
Color names are not case-sensitive. 

The following color table image shows a color swatch for each of the named colors along with the 
corresponding color name, and hexadecimal value that you can use to render an area in that color. 
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This example uses the SolidColorBrush class in "Longhorn" markup language (code-named "XAML") to 
color areas such as the window background and the border and interior of shapes. The SolidColorBrush 
creates fills that are uniform in color— it can't create gradient or pattern fills. SolidColorBrush uses both 
predefined color values and hexadecimal color values. In this example, several Ellipse shapes are 
created with identical fills and outlines, but the fills and outlines are specified in different formats to 
demonstrate the versatility of the SolidColorBrush class. 

In the following markup, a Canvas element is declared and its Background property is set to LightGray, 
one of the predefined colors. 

<Canvas ID="root" xmlns= ,, http://schemas.microsoft.com/2003/xaml" 
Background="LightGray"> 

In the next example, the Fill and Stroke properties of an Ellipse are set using ARGB notation. ARGB 
consists of a pound sign (#) and eight digits. The pound sign indicates that the digits that follow are in 
hexidecimal (base-16) format. The first two digits specify the alpha value, or opacity, of the color. FF 
indicates a color that is fully opaque, while 00 indicates a color that is completely transparent. The next 
six digits of the number specify the red, green, and blue values of the color. 
The fill of the Ellipse is set to #FFFFFF00, which specifies a color that is fully opaque (FF), has the 
maximum amount of red (FF), the maximum amount of green (FF), and no blue(OO). This combination 
produces yellow. 

<Ellipse 
Fill="#FFFFFF00" 
CenterX="100" 
CenterY="200" 
RadiusX="75" 
RadiusY="75 n 
StrokeThickness="5" 
Stroke="#FF0000FF7> 

In the next example, the Fill and Stroke properties of an Ellipse are set using shorter hexidecimal 
notation. The alpha value is omitted, and one digit is used for each red, green, and blue value instead of 
two. The resulting Ellipse has colors identical to the first. 

<Ellipse 
Fill="#FF0" 
CenterX="200" 
CenterY="200 M 
RadiusX="75" 
RadiusY="75" 
StrokeThickness="5" 
Stroke="#00F7> 

In the next example, the Fill and Stroke properties of an Ellipse are set using two of the predefined colors, 
Yellow and Blue. The resulting Ellipse has colors identical to the previous two. 

<Ellipse 
FiII="YeIlow" 
CenterX="300" 
CenterY= n 200" 
RadiusX= M 75" 
RadiusY="75 n 
StrokeThickness="5 M 
Stroke= ,, Blue'7> 
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In the final example, the Fill property of a Polyline is set by explicitly declaring a SolidColorBrush. The 
Color property of the SolidColorBrush is set to Blue, and its Opacity property is set to 0.4, creating a fill 
that is blue and 40 percent opaque (or 60 percent translucent). 

<Polyline 

Points="300,200 400,125 400,275 300,200" 

Stroke="Purple" 

StrokeThickness="2.3 M > 

<Polyline.Fill> 
<SolidColorBrush Color="Blue" Opacity="0.47> 
</Polyline.Fill> 

</Polyline> 

</Canvas> 

This example demonstrates several equivalent ways to specify color values to fill an area using code. The 
simplest syntax uses a named color property from the Brushes class. The Colors class provides the same 
named color properties which you can pass as an argument to SolidColorBrush. The example also shows 
how to pass Color values to SolidColorBrush as separate alpha, red, green, and blue values using the 
Color structure's static FromScRGB method. The example draws identical Ellipse shapes using identical 
colors specified in these different ways. 

II C# 

II Create the ellipses. 
Ellipse e1 = new EllipseQ; 
Ellipse e2 = new Ellipse(); 
Ellipse e3 = new Ellipse(); 

// Set the fill value for the interior of each ellipse in 

// different ways that have identical results. 

el.Fill = Brushes.Blue; 

e2.Fill = new SolidColorBrush(Colors.Blue); 

e3.Fill = new SolidColorBrush(Color.FromScRGB(1,0,0,1)); 

// Set the stroke value for the interior of each ellipse in 

// different ways that have identical results. 

e1. Stroke = Brushes.Black; 

e2.Stroke = new SolidColorBrush(Colors.Black); 

e3.Stroke = new SolidColorBrush(Color.FromScRGB(1, 0,0,0)); 



This sample demonstrates only a few of the ways to instantiate Color objects. See Color for more 
information. 

In order to actually render the ellipse the example also sets values for the StrokeThickness, CenterX, 
CenterY, RadiusX, and RadiusY properties in order to set the size and position of each ellipse. 

// C# 

// Set the thickness of the stroke. 
e1. StrokeThickness = new Length(10); 
e2.StrokeThickness = new Length(10); 
e3.StrokeThickness = new Length(10); 

// Set the size and position of the ellipses. 
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el.CenterX = new Length(100); 
el.CenterY = new Length(75); 
el.RadiusX = new Length(50); 
el.RadiusY = new Length(50); 

e2.CenterX = new Length(220); 
e2.CenterY = new Length(75); 
e2.RadiusX = new Length(50); 
e2.RadiusY = new Length(50); 

e3.CenterX = new Length(340); 
e3.CenterY = new Length(75); 
e3.RadiusX = new Length(50); 
e3.RadiusY = new Length(50); 



The following code sample shows how to programatically change the Background color of a Border 
element A Button element is placed near the center of a containing Canvas. The Canvas is nested within 
a Border element in order to display background and border properties. When the Button is clicked the 
Brush color of the Border element is programatically changed to LightSteelBlue. In addition, Text is added 
to the Canvas indicating that the event has occurred. The text content of the Button element is also 
updated. 

[C#] 

<Border ID= M root" 

xmlns= ,, http://schemas.microsoft.com/2003/xaml n 

xmlns:def="Definition" 

BorderThickness="2" 

BorderBrush="black" 

Background= M LightGray" 

Width="350" 

Height="350"> 

<Canvas> 

<Button ID="btn" Canvas.Top="40" Canvas. Left="40" Background="LightSkyBlue" Width= M 100" 
Height="35" Click="ChangeBG">Click Me to change the Background Color</Button> 
<Text Canvas.Top="130" Canvas. Left="40" ID="Text1">Waiting for Click! </Text> 

<def:Code> 
<![CDATA[ 

void ChangeBG(object sender, MSAvalon.Windows.Controls.ClickEventArgs e) 

root. Background = MSAvalon. Windows. Media. Brushes. LightSteelBlue* 
btn.Content = "Clicked!"; 

Text1.TextRange.Text = "The background is now LightSteelBlue"; 
]]> 

</def:Code> 
</Canvas> 
</Border> 

The following code example shows how to complete the same operation in Microsoft Visual Basic® .NET. 
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[Visual Basic] 



<Border ID="root" 

xmlns="http://schemas.microsoft.com/2003/xamr 
xmlns:def="Definition" 

BorderThickness="2" 

BorderBrush="black" 

Background="LightGray" 

Width="350" 

Height="350"> 

<Canvas> 

<Button ID="btn" Canvas.Top="40" Canvas. Left="40" Background="LightSkyBlue" Width="100" 
Height="35" ~ " 

Click="ChangeBG">Click Me to change the Background Color</Button> 

<Text Canvas.Top="130" Canvas. Left="40" ID="Text1">Waiting for Click!</Text> 

<def:Code> 
<![CDATA[ 

Sub ChangeBG(ByVal sender As Object, ByVal e As MSAvalon.Windows.Controls.ClickEventArgs) 
root Background = MSAvalon.Windows.Media.Brushes.LightSteelBlue 
btn.Content = "Clicked!" 

Text1.TextRange.Text = "The background is now LightSteelBlue" 

End Sub 
]]> 

</def:Code> 
</Canvas> 
</Border> 

The following code example shows how to create a DockPanel in C#. Five Rectangle elements are 
instantiated and stacked within a parent DockPanel to partition space. Each rectangle is "Docked" within 
the parent DockPanel, with the final Rectangle set to "Fill" the remaining space. 



using System; 

using MSAvalon.Windows; 

using MSAvalon.Windows.Controls; 

using MSAvalon.Windows.Media; 

namespace Canvas_Demo 
{ 

public class MyApp : MSAvalon.Windows.Application 

MSAvalon.Windows. Shapes. Rectangle recti ; 
MSAvalon.Windows.Shapes.Rectangle rect2; 
MSAvalon.Windows.Shapes.Rectangle rect3; 
MSAvalon.Windows.Shapes. Rectangle rect4; 
MSAvalon.Windows.Shapes.Rectangle rect5; 
MSAvalon.Windows. Controls. DockPanel dockPanel; 
MSAvalon.Windows.Window mainWindow; 

protected override void OnStartingUp (StartingUpCancelEventArgs e) 
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{ 

base.OnStartingUp (e); 
CreateAndShowMainWindow (); 



private void CreateAndShowMainWindow () 
{ 

// Create the application's main window 
mainWindow = new MSAvalon.Windows. Window (); 

// Create a DockPanel with a width and height of 500 pixels 
dockPanel = new DockPanel (); 

dockPanel. Background = MSAvalon.Windows.Media. Brushes.Snow; 
mainWindow.Children.Add (dockPanel); 
dockPanel.Width = new Length (500); 
dockPanel. Height = new Length (500); 

// Add the first rectangle to the DockPanel 

recti = new MS Avalon.Windows.Shapes. Rectangle (); 

recti. Stroke = MSAvalon.Windows.Media.Brushes.Black; 

recti. Fill = MSAvalon.Windows.Media.Brushes.CadetBlue; 

recti .Width = new Length (500); 

recti. Height = new Length (25); 

MSAvalon.Windows.Controls.DockPanel.SetDock(rect1 
MSAvalon.Windows.Controls.Dock.Top); . 

dockPanel.Children.Add (recti); 
mainWindow. Show (); 

// Add the second rectangle to the DockPanel 

rect2 = new MSAvalon.Windows.Shapes. Rectangle (); 

rect2.Stroke = MSAvalon.Windows.Media.Brushes.Black; 

rect2.Fill = MSAvalon.Windows.Media. Brushes.LightSteelBlue' 

rect2.Width = new Length (500); 

rect2.Height = new Length (25); 

MSAvalon.Windows.Controls.DockPanel.SetDock(rect2 
MSAvalon.Windows.Controls.Dock.Top); 

dockPanel.Children.Add (rect2); 
mainWindow. Show (); 

// Add the third rectangle to the DockPanel 

rect4 = new MSAvalon.Windows.Shapes. Rectangle (); 

rect4.Stroke = MSAvalon.Windows.Media. Brushes.Black; 

rect4.Fill = MSAvalon.Windows.Media.Brushes.Teal; 

rect4.Width = new Length (500); 

rect4. Height = new Length (50); 

MSAvalon.Windows.Controls.DockPanel.SetDock(rect4 
MSAvalon.Windows. Controls. Dock. Bottom); 

dockPanel.Children.Add (rect4); 
mainWindow. Show (); 

// Add the fourth rectangle to the DockPanel 

rect3 = new MSAvalon.Windows.Shapes.Rectangle (); 

rect3.Stroke = MSAvalon.Windows.Media. Brushes. Black; 

rect3.Fill = MSAvalon.Windows.Media. Brushes. DarkSeaGreen; 

rect3.Width = new Length (200); 

rect3. Height = new Length (400); 
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MSAvalon.Windows.Controls.DockPanel.SetDock(rect3, 
MSAvalon.Windows.Controls.Dock.Left); 

dockPanel.Children.Add (rect3); 
mainWindow.Show (); 

// Add the fifth rectangle to the DockPanel 
rectS = new MSAvalon.Windows.Shapes.Rectangle (); 
rectS.Stroke = MSAvalon. Windows.Media.Brushes.Black; 
rectS.Fill = MSAvalon.Windows.Media.Brushes.SlateGray; 
MSAvalon.Windows.Controls.DockPanel.SetDock(rect5, 
MSAvalon.Windows.Controls.Dock.Fill); 

dockPanel.Children.Add (rect5); 
mainWindow.Show (); 

} 

} 

internal sealed class EntryClass 
{ 

[System.STAThread()] 
private static void Main () 
{ 

MyApp app = new MyApp (); 
app.Run (); 

} 

} 

} 

The following code example shows how to complete the same operation in Visual Basic .NET. 
[Visual Basic] 

<DockPanel ID="myDP" 

xmlns='Mp://schemas.microsoft.com/2003/xamr 
xmlns:def= , "Definition" 
Background-'Snow" 
Loaded="onlnit" 
Width="500" 
Height= ,, 500"> 
<def:Code> 
<![CDATA[ 

Private Sub onlnit(ByVal sender as object, ByVal args as System.EventArgs) 

' Add the first Rectangle to the DockPanel 

Dim recti As new MSAvalon.Windows.Shapes.Rectangle 

recti. Stroke = Brushes. Black 

rectlFill = Brushes.CadetBlue 

recti .Width = new MSAvalon. Windows. Length(500) 

rectlHeight = new MSAvalon.Windows.Length(25) 

SetDock(rect1 , MSAvalon. Windows.Controls.Dock.Top) 

myDP.Children.Add(rect1 ) 

' Add the second Rectangle to the DockPanel 

Dim rect2 As new MSAvalon. Windows.Shapes. Rectangle 

rect2.Stroke = Brushes. Black 

rect2.Fill = Brushes.LightSteelBlue 

rect2. Width = new MS Avalon. Windows. Length(500) 

rect2.Height = new MSAvalon. Windows. Length(25) 
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SetDock(rect2, MSAvalon.Windows.Controls.Dock.Top) 
myDP.Children.Add(rect2) 



' Add the third Rectangle to the DockPanel 

Dim rect3 As new MSAvalon.Windows.Shapes.Rectangle 

rect3.Stroke = Brushes.Black 

rect3.Fill = Brushes.Teal 

rect3. Width = new MSAvalon. Windows. Length(500) 
rect3. Height = new MSAvalon. Windows. Length(50) 
SetDock(rect3, MSAvalon.Windows.Controls.Dock.Bottom) 
myDP.Children.Add(rect3) 

' Add the fourth Rectangle to the DockPanel 

Dim rect4 As new MSAvalon. Windows.Shapes. Rectangle 

rect4.Stroke = Brushes.Black 

rect4.Fill = Brushes. DarkSeaGreen 

rect4. Width = new MSAvalon. Windows. Length(200) 

rect4. Height = new MSAvalon. Windows. Length(400) 

SetDock(rect4, MSAvalon.Windows.Controls.Dock.Left) 

myDP.Children.Add(rect4) 

' Add the fourth Rectangle to the DockPanel 

Dim rect5 As new MSAvalon. Windows.Shapes. Rectangle 

rectS.Stroke = Brushes. Black 

rectS.Fill = Brushes.SlateGray 

SetDock(rect5, MSAvalon. Windows. Controls. Dock. Fill) 
myDP.Children.Add(rect5) 

End Sub 
]]> 

</def:Code> 
</DockPanel> 

CloseSegment Class 

Definition: Represents a line that connects the last point of a PathFigure object with its starting point. 

Description 

Returns a modifiable shallow or deep clone of the current object. 
This abstract method must be implemented by classes that 
derive from Changeable. Inherited from Changeable. 
Implementation of Animatable.CloneCore. 

Returns an immutable copy of the specified object. Inherited 
from Changeable. 

Initializes a new instance of the CloseSegment class. 

Creates a copy of this CloseSegment. 

Creates a copy of this PathSegment. Inherited from 
PathSegment. 

Returns a modifiable copy of the current object. The copy's 
IsChangeabie property is true and its StatusOfNextUse is 
Unchangeable. Inherited from Changeable. 



Method 

CloneCore 
CloneCore 

CloneDownToUnchangeable 

CloseSegment 
Copy 

Copy 
Copy 
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OisableCore 

EmbeddedAnimationCollectionReader 

EmbeddedAnimationCollectionWriter 

EmbeddedChangeableReader 

EmbeddedChangeableWriter 

EnableCore 

Equals 
Finalize 

GetCurrentValue 
GetCurrentValue 
GetCurrentValue 

GetHashCode 
GetType 

MakeUnchangeable 

MakeUnchangeableCore 
MemberwiseClone 

ModifyHandlerlfChangeable 
OnChanged 

PropagateEventHandler 
ReadPreamble 

ReferenceEquals 

SetDefaultParentTimeline 

SetDefaultParentTimelineCore 
ToString 



Inherited from PathSegment. 

Maybe this should be internal?? Inherited from Animatable. 
Inherited from Animatable. 
Inherited from Animatable. 
Inherited from Animatable. 
Inherited from PathSegment. 

Determines whether two Object instances are equal. Inherited 
from Object. 

Allows an Object to attempt to free resources and perform other 
cleanup operations before the Object is reclaimed by garbage 
collection. Inherited from Object. 

Returns a non-animated version of this GradientStop that 
represents its current state. Inherited from PathSegment. 

Returns a non-animated version of this CloseSegment that 
represents its current state. 

Returns a non-animated version of this Animatable that 
represents its current state. Inherited from Animatable. 

Serves as a hash function for a particular type, suitable for use in 
hashing algorithms and data structures like a hash 
table. Inherited from Object 

Gets the Type of the current instance. Inherited from Object. 
Makes an object immutable; after this method is called on a 
Changeable, its IsChangeable property is false. Inherited from 
Changeable. 

Implementation of MakelinchangeableCore. Inherited from 
PathSegment. 

Creates a shallow copy of the current Object. Inherited from 
Object. 

Adds or removes a Changed event handler to or from the 
specified Changeable object, if the object is currently modifiable. 
If the specified object is not modifiable— if its IsChangeable 
property is false— this method has no effect. Inherited from 
Changeable. 

Called when the current object is modified. Classes that derive 
from Changed should call this method after they have been 
modified. Inherited from Changeable. 

Implementation of PropagateEventHandler. 

Ensures that simple (non-Changeabie) members are being 

accessed from a valid Ul context. This method should be called 

before any simple members are accessed. Inherited from 

Changeable. 

Determines whether the specified Object instances are the same 
instance. Inherited from Object. 

This will change the time parent for animations on any of the 
properties of this Changeable which are inheriting their time 
parent. Inherited from Animatable. 
Inherited from PathSegment. 

Returns a String that represents the current Object. Inherited 
from Object. 
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ValidateObjectState 
WritePostscript 

WritePreamble 



Verifies that the current object has a valid state. If the object is in 
an invalid state, this method throws an exception. Inherited from 
Changeable. 

Causes the current object to validate itself and then invokes the 
OnChanged method. Inherited from Changeable. 

Ensures that simple (non-Changeable) members are being 
accessed from a valid user interface (Ul) context. This method 
should be called before any simple members are set. Inherited 
from Changeable. 



Property 

AllowChangeableReferenceOverride 
CanMakeUnchangeable 

DefaultParentTimeline 

HasAnimations 
IsAnimating 

IsChangeable 

IsOverridingBaseValue 

IsStroked 

StatusOfNextUse 

UlContext 



Description 

Used in conjunction with the ChangeableUsageOverride type sent in 
as a parameter to ChangeableHelper.UseChangeable, to help 
determine when a Changeable being put into "use" should be 
promoted to "ChangeableReference". Inherited from Changeable. 

True if this Changeable can be made unchangeable. Inherited from 
Changeable. 

The current parent Timeline associated with this Animatable. This 
will be the Timeline set to the ParentTimeline property of this 
Animatable if one has been set and if not, the Timeline last passed 
into the SetDefaultParentTimeline method. Inherited from 
Animatable. 

Gets a Boolean that indicates whether the segment has animations. 

Gets a Boolean that indicates whether the object is currently 
modifiable. Inherited from Changeable. 

Gets or sets a Boolean that determines whether the segment is 
stroked. Inherited from PathSegment. 

Gets or sets a UseStatus enumeration that specifies how the 
Changeable object behaves when it is "used." A Changeable object 
is considered used in the following situations: the object is set into a 
Property System property, the object is used as a sub-object in a 
complex Changeable object, or the object is used in a 
DrawingContext command. Inherited from Changeable. 

Gets the UlContext of the current object. The UlContext is used for 
maintaining thread safety. Inherited from Changeable. 



CodecFilter Class 

Definition: Filter for enumerating codecs. Only those codecs that match the properties will be 
enumerated. 



Method 

CodecFilter 
Equals 

Finalize 
GetHashCode 



Description 

Determines whether two Object instances are equal. Inherited from Object. 
Allows an Object to attempt to free resources and perform other cleanup operations 
before the Object is reclaimed by garbage collection. Inherited from Object. 
Serves as a hash function for a particular type, suitable for use in hashing 
algorithms and data structures like a hash table. Inherited from Object. 
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GetType Gets the Type of the current instance. Inherited from Object. 

MemberwiseClone Creates a shallow copy of the current Object. Inherited from Object. 

ReferenceEauals Determines whether the specified Object instances are the same instance. Inherited 

M from Object. 

ToString Returns a String that represents the current Object. Inherited from Object. 



Property Description 

CodecAuthor Who authored the codec. 
FriendlyName The Friendly name of a codec 

HasDecoder Find those codecs that have a matching decoder. Setting this to false means that we don't 
filter on whether or not there is a decoder for that codec. 

HasEncoder Find those codecs that have a matching encoder. Setting this to false means that we don't 
filter on whether or not there is an encoder for that codec. 

ImageStream Find a codec that can handle this image stream. 

IsBuiltln Find those codecs that are built-in (not add-ins). Setting this to false means that we don't 
filter on whether or not the codec is one of the built-in ones. 

MaxVersion The maximum version number of the codec. 

MimeType Which Mime Types the codec supports. 

MinVersion The minimum version number of the codec. 



Codeclnfo Class 

Definition: Information about a specific codec and a factory for creating the codec. This is returned from 
the codec enumerator. 



Method 

Codeclnfo 

CreateDecoderlnstance 
CreateEncoderlnstance 
Equals 

Finalize 

GetHashCode 
GetType 

IslmageSupported 

MatchesFilter 
MemberwiseClone 

ReferenceEquals 
ToString 



Description 

Get an instance of the decoder associated with this codec (if there is one). 
Get an instance of the encoder associated with this codec (if there is one). 
Determines whether two Object instances are equal. Inherited from Object. 
Allows an Object to attempt to free resources and perform other cleanup 
operations before the Object is reclaimed by garbage collection. Inherited from 
Object. 

Serves as a hash function for a particular type, suitable for use in hashing 
algorithms and data structures like a hash table. Inherited from Object. 
Gets the Type of the current instance. Inherited from Object. 
Whether the codec supports this image, based oh looking at the first 
RequiredHeaderSize bytes from the image. The header must contain at least 
the first RequiredHeaderSize bytes from the image. 
Note: this does NOT check/sniff the bytes in the stream. 
Creates a shallow copy of the current Object. Inherited from Object. 

Determines whether the specified Object instances are the same 
instance. Inherited from Object. 

Returns a String that represents the current Object. Inherited from Object. 



Pr perty 

CodecAuthor 
CodecVersion 



Description 



Who authored the codec. 

The version number of the codec. 
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FriendlyName The Friendly name of a codec 
HasDecoder Whether there is a decoder associated with this codec. 

HasEncoder Whether there is an encoder associated with this codec. 

IsBuiltln Whether this codec is one of the built-in ones. 

MimeTypes Which Mime Types the codec supports. 

RequiredHeaderSize The number of b y* es needed from the image header to determine if the image is 
supported by this codec. 



ColorCollection Class 



Method 

Add 

AddRange 

Clear 

CloneCore 

CloneDownToUnchangeable 

ColorCollection 
Contains 

Copy 

Copy 
CopyTo 



Description 



Returns an immutable copy of the specified object. Inherited from 
Changeable. 



Returns a modifiable copy of the current object. The cop/s 
IsChangeable property is true and its StatusOfNextUse is 
Unchangeable. Inherited from Changeable. 



Accesses the specified Changeable data member, processes it, and 
returns a reference to the member. This reference should then be 
EmbeddedChangeableReader reassigned to the original member variable. Classes that derive from 

Changeable call this method on data members before they can be 
retrieved through property calls. Inherited from Changeable. 
Processes a modified Changeable data member and returns a 
reference to the processed object. Inherited from Changeable. 

Determines whether two Object instances are equal. Inherited from 
Object. 

Allows an Object to attempt to free resources and perform other cleanup 
operations before the Object is reclaimed by garbage 
collection. Inherited from Object. 



EmbeddedChangeableWriter 
Equals 



Finalize 



GetEnumerator 

GetHashCode 

GetRange 
GetType 

lAddChild.AddChild 
IAddChild.AddText 



Serves as a hash function for a particular type, suitable for use in 
hashing algorithms and data structures like a hash table. Inherited from 
Object. 

Gets the Type of the current instance. Inherited from Object. 
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IListAdd 

IListContains 

IListJndexOf 

I List. Insert 

I List. Remove 

IndexOf 

insert 

InsertRange 
LastlndexOf 

MakeUnchangeable 

MakeUnchangeableCore 
MemberwiseClone 

ModifyHandlerlfChangeable 



OnChanged 



PropagateEventHandler 



ReadPreamble 



ReferenceEquals 

Remove 
RemoveAt 
RemoveRange 
SetRange 

ToString 



ValidateObjectState 
WritePostscript 

WritePreamble 



Makes an object immutable; after this method is called on a 
Changeable, its IsChangeable property is false. Inherited from 
Changeable. 

Makes a Changeable object immutable. Inherited from Changeable. 
Creates a shallow copy of the current Object. Inherited from Object. 
Adds or removes a Changed event handler to or from the specified 
Changeable object, if the object is currently modifiable. If the specified 
object is not modifiable— if its IsChangeable property is false— this 
method has no effect. Inherited from Changeable. 
Called when the current object is modified. Classes that derive from 
Changed should call this method after they have been 
modified. Inherited from Changeable. 

Shares a Changed event handler with the current object's data 
members or removes it. Inherited from Changeable. 
Ensures that simple (non-Changeable) members are being accessed 
from a valid user interface (Ul) context. This method should be called 
before any simple members are accessed. Inherited from Changeable. 
Determines whether the specified Object instances are the same 
instance. Inherited from Object. 



Returns a String that represents the current Object. Inherited from 
Object. 

Verifies that the current object has a valid state. If the object is in an 
invalid state, this method throws an exception. Inherited from 
Changeable. 

Causes the current object to validate itself and then invokes the 
OnChanged method. Inherited from Changeable. 
Ensures that simple (non-Changeable) members are being accessed 
from a valid Ul context. This method should be called before any simple 
members are set. Inherited from Changeable. 



Pr °P ert y Description 

Used in conjunction with the ChangeableUsageOverride type sent in 
AllowChangeableReferenceOverride as a P arameter to ChangeableHelper.UseChangeable, to help 

determine when a Changeable being put into "use" should be 
promoted to "ChangeableReference". Inherited from Changeable 
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CanMakeUnchangeable 

Capacity 
Count 

IsChangeable 

IsFixedSize 
Item 



StatusOfNextUse 



UlContext 



True if this Changeable can be made unchangeable. Inherited from 
Changeable. 



Gets a Boolean that indicates whether the object is currently 
modifiable. Inherited from Changeable. 



Gets or sets a UseStatus enumeration that specifies how the 
Changeable object behaves when it is "used." A Changeable object 
is considered used in the following situations: the object is set into a 
Property System property, the object is used as a sub-object in a 
complex Changeable object, or the object is used in a 
DrawingContext command. Inherited from Changeable. 
Gets the UlContext of the current object. The UlContext is used for 
maintaining thread safety. Inherited from Changeable. 



ColorCollectionConverter Class 

Definition: ColorCollectionConverter - Converter class for converting instances of other types to and from 
ColorCollection instances. 



Method 

CanConvertFrom 

CanConvertFrom 

CanConvertTo 

CanConvertTo 

ColorCollectionConverter 

ConvertFrom 

ConvertFrom 

ConvertFromlnvariantString 

ConvertFromString 

ConvertTo 

ConvertTo 

ConvertTolnvariantString 

ConvertToString 

Createlnstance 

Equals 
Finalize 

GetCon vert From Exception 
GetConvertToException 



Description 

Inherited from TypeConverter. 

CanConvertFrom - Returns whether or not this class can convert from a 
given type. 

Inherited from TypeConverter. 

CanConvertTo - Returns whether or not this class can convert to a given 
type. 

ConvertFrom - Attempt to convert to a ColorCollection from the given 
object 

Inherited from TypeConverter. 
Inherited from TypeConverter. 
Inherited from TypeConverter. 

ConvertTo - Attempt to convert a ColorCollection to the given type 
Inherited from TypeConverter. 
Inherited from TypeConverter. 
Inherited from TypeConverter. 
Inherited from TypeConverter. 

Determines whether two Object instances are equal. Inherited from 
Object. 

Allows an Object to attempt to free resources and perform other cleanup 
operations before the Object is reclaimed by garbage 
collection. Inherited from Object. 

Inherited from TypeConverter. 

Inherited from TypeConverter. 
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GetCreatelnstanceSupported 

GetHashCode 

GetProperties 

GetPropertiesSupported 

GetStandardValues 

GetStandardValuesExclusive 

GetStandardValuesSupported 

GetType 

IsValid 

MemberwiseClone 
ReferenceEquals 
SortProperties 
ToString 



Inherited from TypeConverter. 

Serves as a hash function for a particular type, suitable for use in 
hashing algorithms and data structures like a hash table. Inherited from 
Object 

Inherited from TypeConverter. 
Inherited from TypeConverter. 
Inherited from TypeConverter. 
Inherited from TypeConverter. 
Inherited from TypeConverter. 

Gets the Type of the current instance. Inherited from Object. 
Inherited from TypeConverter. 

Creates a shallow copy of the current Object. Inherited from Object. 

Determines whether the specified Object instances are the same 
instance. Inherited from Object. 

Inherited from TypeConverter. 

Returns a String that represents the current Object. Inherited from 
Object. 



ColorContext Class 



Method 

ColorContext 
Equals 

Finalize 

GetHashCode 
GetType 

MemberwiseClone 
ReferenceEquals 

ToString 



Description 

ColorContext construct StandardColorSpace 

Determines whether two Object instances are equal. Inherited from Object. 
Allows an Object to attempt to free resources and perform other cleanup 
operations before the Object is reclaimed by garbage collection. Inherited from 
Object. 

Serves as a hash function for a particular type, suitable for use in hashing 
algorithms and data structures like a hash table. Inherited from Object. 
Gets the Type of the current instance. Inherited from Object. 
Creates a shallow copy of the current Object. Inherited from Object. 

Determines whether the specified Object instances are the same 
instance. Inherited from Object. 

Returns a String that represents the current Object. Inherited from Object. 



Property 



ICCProfile 



Description 



ICCProfile property 



CoiorCollectionConverter Class 

Definition: CoiorCollectionConverter - Converter class for converting instances of other types to and from 
ColorCollection instances. 

Meth d Description 

CanConvertFrom Inherited from TypeConverter. 



44 



CanConvertFrom 

CanConvertTo 

CanConvertTo 

ColorCollectionConverter 

ConvertFrom 

ConvertFrom 

ConvertFrom I nvariantString 

ConvertFromString 

ConvertTo 

ConvertTo 

ConvertTolnvariantString 

ConvertToString 

Createlnstance 

Equals 



Finalize 

GetConvertFromException 

GetConvertToException 

GetCreatelnstanceSupported 

GetHashCode 

GetProperties 

GetPropertiesSupported 

GetStandardValues 

GetStandardVaiuesExclusive 

GetStandardValuesSupported 

GetType 

IsValtd 

MemberwiseClone 
ReferenceEquals 
SortProperties 
ToString 



CanConvertFrom - Returns whether or not this class can convert from a 
given type. 

Inherited from TypeConverter. 

CanConvertTo - Returns whether or not this class can convert to a given 
type. 

ConvertFrom - Attempt to convert to a ColorCollection from the given 
object 

Inherited from TypeConverter. 
Inherited from TypeConverter. 
Inherited from TypeConverter. 

ConvertTo - Attempt to convert a ColorCollection to the given type 
Inherited from TypeConverter. 
Inherited from TypeConverter. 
Inherited from TypeConverter. 
Inherited from TypeConverter. 

Determines whether two Object instances are equal. Inherited from 
Object. 

Allows an Object to attempt to free resources and perform other cleanup 
operations before the Object is reclaimed by garbage 
collection. Inherited from Object. 

Inherited from TypeConverter. 

Inherited from TypeConverter. 

Inherited from TypeConverter. 

Serves as a hash function for a particular type, suitable for use in 
hashing algorithms and data structures like a hash table. Inherited from 
Object. 

Inherited from TypeConverter. 
Inherited from TypeConverter. 
Inherited from TypeConverter. 
Inherited from TypeConverter. 
Inherited from TypeConverter. 

Gets the Type of the current instance. Inherited from Object. 
Inherited from TypeConverter. 

Creates a shallow copy of the current Object. Inherited from Object. 

Determines whether the specified Object instances are the same 
instance. Inherited from Object. 

Inherited from TypeConverter. 

Returns a String that represents the current Object. Inherited from 
Object. 



ColorContext Class 



Method Description 

ColorContext ColorContext construct StandardColorSpace 

Equals Determines whether two Object instances are equal. Inherited from Object. 
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Allows an Object to attempt to free resources and perform other cleanup 
Finalize operations before the Object is reclaimed by garbage collection. Inherited from 

Object. 

GetHashCode Serves as a hash function for a particular type, suitable for use in hashing 

algorithms and data structures like a hash table. Inherited from Object. 
GetType Gets the Type of the current instance. Inherited from Object. 

MemberwiseClone Creates a shallow copy of the current Object. Inherited from Object. 



ReferenceEquals 
ToString 



Determines whether the specified Object instances are the same 
instance. Inherited from Object. 

Returns a String that represents the current Object. Inherited from Object. 



Property 



Description 



ICCProfile 



ICCProfile property 



ColorConverter Class 

Definition: Used to convert a Color object to or from another object type. 



Method 

CanConvertFrom 

CanConvertFrom 

CanConvertTo 

CanConvertTo 

ColorConverter 

ConvertFrom 

ConvertFrom 

ConvertFromlnvariantString 
ConvertFromString 

ConvertTo 

ConvertTo 

ConvertTolnvariantString 

ConvertToString 

Createlnstance 

Equals 
Finalize 

GetCon vertFrom Exception 

GetConvertToException 

GetCreatelnstanceSupported 

GetHashCode 



Description 

Inherited from TypeConverter. 

Determines whether an object of a given type can be converted to a 
Color object. 

Inherited from TypeConverter. 

Determines whether this class can convert an object of a given type to 
the specified destination type. 

Initializes a new instance of the ColorConverter class. 

Converts from an object of a given type to a Color object. 

Inherited from TypeConverter. 

Inherited from TypeConverter. 
Converts a string to a color. 

Converts a Color object to a specified type, using the specified context 
and culture information. 

Inherited from TypeConverter. 

Inherited from TypeConverter. 

Inherited from TypeConverter. 

Inherited from TypeConverter. 

Determines whether two Object instances are equal. Inherited from 
Object. 

Allows an Object to attempt to free resources and perform other cleanup 
operations before the Object is reclaimed by garbage 
collection. Inherited from Object. 

Inherited from TypeConverter. 

Inherited from TypeConverter. 

Inherited from TypeConverter. 

Serves as a hash function for a particular type, suitable for use in 
hashing algorithms and data structures like a hash table. Inherited from 
Object. 
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GetProperties 

GetPropertiesSupported 

GetStandardValues 

GetStandardValuesExclusive 

GetStandardValuesSupported 

GetType 

IsValid 

MemberwiseClone 
ReferenceEquals 
SortProperties 
ToString 



Inherited from TypeConverter. 
Inherited from TypeConverter. 
Inherited from TypeConverter. 
Inherited from TypeConverter. 
Inherited from TypeConverter. 

Gets the Type of the current instance. Inherited from Object. 
Inherited from TypeConverter. 

Creates a shallow copy of the current Object. Inherited from Object. 

Determines whether the specified Object instances are the same 
instance. Inherited from Object. 

Inherited from TypeConverter. 

Returns a String that represents the current Object. Inherited from 
Object. 



Colors Class 

Definition: Implements a set of predefined colors. 



Method 

Colors 
Equals 

Finalize 

GetHashCode 
GetType 

MemberwiseClone 
ReferenceEquals 

ToString 

Property 

AliceBlue 

AntiqueWhite 

Aqua 

Aquamarine 

Azure 

Beige 

Bisque 

Black 

BlanchedAlmond 
Blue 

BlueViolet 

Brown 

BurlyWood 



Description 

Instantiates the Colors class. 

Determines whether two Object instances are equal. Inherited from Object. 
Allows an Object to attempt to free resources and perform other cleanup 
operations before the Object is reclaimed by garbage collection. Inherited from 
Object. 

Serves as a hash function for a particular type, suitable for use in hashing 
algorithms and data structures like a hash table. Inherited from Object. 
Gets the Type of the current instance. Inherited from Object. 
Creates a shallow copy of the current Object. Inherited from Object. 

Determines whether the specified Object instances are the same 
instance. Inherited from Object. 

Returns a String that represents the current Object. Inherited from Object. 



Gets the 
Gets the 
Gets the 
Gets the 
Gets the 
Gets the 
Gets the 
Gets the 
Gets the 
Gets the 
Gets the 
Gets the 
Gets the 



system-defined 
system-defined 
system-defined 
system-defined 
system-defined 
system-defined 
system-defined 
system-defined 
system-defined 
system-defined 
system-defined 
system-defined 
system-defined 



Description 

color that has an ARGB 
color that has an ARGB 
color that has an ARGB 
color that has an ARGB 
color that has an ARGB 
color that has an ARGB 
color that has an ARGB 
color that has an ARGB 
color that has an ARGB 
color that has an ARGB 
color that has an ARGB 
color that has an ARGB 
color that has an ARGB 



value of #FFF0F8FF. 
value of #FFFAEBD7. 
value of #FF00FFFF. 
value of #FF7FFFD4. 
value of #FFF0FFFF. 
value of #FFF5F5DC. 
value of #FFFFE4C4. 
value of#FF000000. 
value of #FFFFEBCD. 
value of#FF0000FF. 
value of #FF8A2BE2. 
value of #FFA52A2A. 
value of #FFDEB887. 
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CadetBlue 
Chartreuse 
Chocolate 
Coral 

CornflowerBlue 

Comsilk 

Crimson 

Cyan 

DarkBlue 

DarkCyan 

DarkGoIdenrod 

DarkGray 

DarkGreen 

DarkKhaki 

DarkMagenta 

DarkOliveGreen 

DarkOrange 

DarkOrchid 

DarkRed 

DarkSalmon 

DarkSeaGreen 

DarkSlateBlue 

DarkSlateGray 

DarkTurquoise 

DarkViolet 

DeepPink 

DeepSkyBlue 

DimGray 

DodgerBlue 

Firebrick 

FloralWhite 

ForestGreen 

Fuchsia 

Gainsboro 

GhostWhite 

Gold 

Goldenrod 

Gray 

Green 

GreenYellow 

Honeydew 

HotPink 

IndianRed 

Indigo 



Gets the 
Gets the 
Gets the 
Gets the 
Gets the 
Gets the 
Gets the 
Gets the 
Gets the 
Gets the 
Gets the 
Gets the 
Gets the 
Gets the 
Gets the 
Gets the 
Gets the 
Gets the 
Gets the 
Gets the 
Gets the 
Gets the 
Gets the 
Gets the 
Gets the 
Gets the 
Gets the 
Gets the 
Gets the 
Gets the 
Gets the 
Gets the 
Gets the 
Gets the 
Gets the 
Gets the 
Gets the 
Gets the 
Gets the 
Gets the 
Gets the 
Gets the 
Gets the 
Gets the 



system-defined 
system-defined 
system-defined 
system-defined 
system-defined 
system-defined 
system-defined 
system-defined 
system-defined 
system-defined 
system-defined 
system-defined 
system-defined 
system-defined 
system-defined 
system-defined 
system-defined 
system-defined 
system-defined 
system-defined 
system-defined 
system-defined 
system-defined 
system-defined 
system-defined 
system-defined 
system-defined 
system-defined 
system-defined 
system-defined 
system-defined 
system-defined 
system-defined 
system-defined 
system-defined 
system-defined 
system-defined 
system-defined 
system-defined 
system-defined 
system-defined 
system-defined 
system-defined 
system-defined 



color that has 
color that has 
color that has 
color that has 
color that has 
color that has 
color that has 
color that has 
color that has 
color that has 
color that has 
color that has 
color that has 
color that has 
color that has 
color that has 
color that has 
color that has 
color that has 
color that has 
color that has 
color that has 
color that has 
color that has 
color that has 
color that has 
color that has 
color that has 
color that has 
color that has 
color that has 
color that has 
color that has 
color that has 
color that has 
color that has 
color that has 
color that has 
color that has 
color that has 
color that has 
color that has 
color that has 
color that has 



an ARGB 
an ARGB 
an ARGB 
an ARGB 
an ARGB 
an ARGB 
an ARGB 
an ARGB 
an ARGB 
an ARGB 
an ARGB 
an ARGB 
an ARGB 
an ARGB 
an ARGB 
an ARGB 
an ARGB 
an ARGB 
an ARGB 
an ARGB 
an ARGB 
an ARGB 
an ARGB 
an ARGB 
an ARGB 
an ARGB 
an ARGB 
an ARGB 
an ARGB 
an ARGB 
an ARGB 
an ARGB 
an ARGB 
an ARGB 
an ARGB 
an ARGB 
an ARGB 
an ARGB 
an ARGB 
an ARGB 
an ARGB 
an ARGB 
an ARGB 
an ARGB 



value of #FF5F9EA0. 
value of #FF7FFF00. 
value of#FFD2691E. 
value of #FFFF7F50. 
value of#FF6495ED. 
value of #FFFFF8DC. 
value of#FFDC143C. 
value of #FF00FFFF. 
value of#FF00008B. 
value of#FF008B8B. 
value of#FFB8860B. 
value of #FFA9A9A9. 
value of#FF006400. 
value of #FFBDB76B. 
value of#FF8B008B. 
value of#FF556B2F. 
value of#FFFF8C00. 
value of#FF9932CC. 
value of#FF8B0000. 
value of#FFE9967A. 
value of #FF8FBC8B. 
value of#FF483D8B. 
value of #FF2F4F4F. 
value of#FF00CED1. 
value of#FF9400D3. 
value of#FFFF1493. 
value of #FF00BFFF. 
value of#FF696969. 
value of #FF1E90FF. 
value of#FFB22222. 
value of #FFFFFAF0. 
value of#FF228B22. 
value of #FFFF00FF. 
value of #FFDCDCDC. 
value of #FFF8F8FF. 
value of #FFFFD700. 
value of #FFDAA520. 
value of#FF808080. 
value of #FF008000. 
value of #FFADFF2F. 
value of #FFF0FFF0. 
value of #FFFF69B4. 
value of #FFCD5C5C. 
value of #FF4B0082. 
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Ivory 

Khaki 

Lavender 

LavenderBlush 

LawnGreen 

LemonChiffon 

LightBlue 

LightCoral 

LightCyan 

LightGoldenrodYellow 

LightGray 

LightGreen 

LightPink 

LightSalmon 

LightSeaGreen 

LightSkyBlue 

LightSlateGray 

LightSteelBlue 

LightYellow 

Lime 

LimeGreen 
Linen 
Magenta 
Maroon 

MediumAquamarine 

MediumBlue 

MediumOrchid 

MediumPurple 

MediumSeaGreen 

MediumSlateBiue 

MediumSpringGreen 

Med i u mTu rq uoise 

MediumVioletRed 

MidnightBlue 

MintCream 

MistyRose 

Moccasin 

NavajoWhite 

Navy 

OtdLace 

Olive 

OliveDrab 

Orange 

OrangeRed 



Gets the system-defined color that has an ARGB value of #FFFFFFF0. 
Gets the system-defined color that has an ARGB value of #FFF0E68C. 

Gets the system-defined color that has an ARGB value of #FFE6E6FA. 

Gets the system-defined color that has an ARGB value of #FFFFF0F5. 

Gets the system-defined color that has an ARGB value of #FF7CFC0O. 

Gets the system-defined color that has an ARGB value of #FFFFFACD. 

Gets the system-defined color that has an ARGB value of #FFADD8E6. 

Gets the system-defined color that has an ARGB value of #FFF08080. 

Gets the system-defined color that has an ARGB value of #FFE0FFFF. 

Gets the system-defined color that has an ARGB value of #FFFAFAD2. 

Gets the system-defined color that has an ARGB value of #FFD3D3D3. 

Gets the system-defined color that has an ARGB value of #FF90EE90. 

Gets the system-defined color that has an ARGB value of #FFFFB6C1. 

Gets the system-defined color that has an ARGB value of #FFFFA07A. 

Gets the system-defined color that has an ARGB value of #FF20B2AA. 

Gets the system-defined color that has an ARGB value of #FF87CEFA. 

Gets the system-defined color that has an ARGB value of #FF778899. 

Gets the system-defined color that has an ARGB value of #FFB0C4DE. 

Gets the system-defined color that has an ARGB value of #FFFFFFE0. 

Gets the system-defined color that has an ARGB value of #FF00FF00. 

Gets the system-defined color that has an ARGB value of #FF32CD32. 

Gets the system-defined color that has an ARGB value of #FFFAF0E6. 

Gets the system-defined color that has an ARGB value of #FFFF00FF. 

Gets the system-defined color that has an ARGB value of #FF800000. 

Gets the system-defined color that has an ARGB value of #FF66CDAA. 

Gets the system-defined color that has an ARGB value of #FF0000CD. 

Gets the system-defined color that has an ARGB value of #FFBA55D3. 

Gets the system-defined color that has an ARGB value of #FF9370DB. 

Gets the system-defined color that has an ARGB value of #FF3CB371. 

Gets the system-defined color that has an ARGB value of #FF7B68EE. 
Gets the system-defined color that has an ARGB value of #FF00FA9A. 
Gets the system-defined color that has an ARGB value of #FF48D1CC. 
Gets the system-defined color that has an ARGB value of #FFC71585. 
Gets the system-defined color that has an ARGB value of #FFt 91970. 
Gets the system-defined color that has an ARGB value of #FFF5FFFA. 
Gets the system-defined color that has an ARGB value of #FFFFE4E1 . 
Gets the system-defined color that has an ARGB value of #FFFFE4B5. 
Gets the system-defined color that has an ARGB value of #FFFFDEAD. 
Gets the system-defined color that has an ARGB value of #FF000080. 
Gets the system-defined color that has an ARGB value of #FFFDF5E6. 
Gets the system-defined color that has an ARGB value of #FF808000. 
Gets the system-defined color that has an ARGB value of #FF6B8E23. 
Gets the system-defined color that has an ARGB value of #FFFFA500. 
Gets the system-defined color that has an ARGB value of #FFFF4500. 
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° rchid Gets the system-defined color that has an ARGB value of #FFDA70D6. 

PaleGoldenrod Gets the system-defined color that has an ARGB value of #FFEEE8AA. 

PaleGreen Gets the system-defined color that has an ARGB value of #FF98FB98. 

PaleTurquoise Gets the system-defined color that has an ARGB value of #FFAFEEEE. 

PaleVioletRed Gets the system-defined color that has an ARGB value of #FFDB7093. 

PapayaWhip Gets the system-defined color that has an ARGB value of #FFFFEFD5. 

PeachPuff Gets the system-defined color that has an ARGB value of #FFFFDAB9. 

Peru Gets the system-defined color that has an ARGB value of #FFCD853F. 

Pink Gets the system-defined color that has an ARGB value of #FFFFC0CB. 

Plum Gets the system-defined color that has an ARGB value of #FFDDA0DD. 

PowderBlue Gets the system-defined color that has an ARGB value of #FFB0E0E6. 

Pur P |e Gets the system-defined color that has an ARGB value of #FF800080. 

Red Gets the system-defined color that has an ARGB value of #FFFF0000. 

RosyBrown Gets the system-defined color that has an ARGB value of #FFBC8F8F. 

RoyalBlue Gets the system-defined color that has an ARGB value of #FF4169E1 . 

SaddleBrown Gets the system-defined color that has an ARGB value of #FF8B451 3. 

Sa,mon Gets the system-defined color that has an ARGB value of #FFFA8072. 

SandyBrown Gets the system-defined color that has an ARGB value of #FFF4A460. 

SeaGreen Gets the system-defined color that has an ARGB value of #FF2E8B57. 

SeaShell Gets the system-defined color that has an ARGB value of #FFFFF5EE. 

Sienna Gets the system-defined color that has an ARGB value of #FFA0522D. 

Silver Gets the system-defined color that has an ARGB value of #FFC0C0C0. 

Sk y Blue Gets the system-defined color that has an ARGB value of #FF87CEEB. 

SlateBlue Gets the system-defined color that has an ARGB value of #FF6A5ACD. 

SlateGray Gets the system-defined color that has an ARGB value of #FF708090. 

Snow Gets the system-defined color that has an ARGB value of #FFFFFAFA. 

SpringGreen Gets the system-defined color that has an ARGB value of #FF00FF7F. 

SteelBlue Gets the system-defined color that has an ARGB value of #FF4682B4. 

Tan Gets the system-defined color that has an ARGB value of #FFD2B48C. 

Teal Gets the system-defined color that has an ARGB value of #FF008080. 

Thistle Gets the system-defined color that has an ARGB value of #FFD8BFD8. 

Tomato Gets the system-defined color that has an ARGB value of #FFFF6347. 

Transparent Gets the system-defined color that has an ARGB value of #00FFFFFF. 

Turquoise Gets the system-defined color that has an ARGB value of #FF40E0D0. 

Violet Gets the system-defined color that has an ARGB value of #FFEE82EE. 

Wneat Gets the system-defined color that has an ARGB value of #FFF5DEB3. 

White Gets the system-defined color that has an ARGB value of #FFFFFFFF. 

WhiteSmoke Gets the system-defined color that has an ARGB value of #FFF5F5F5. 

Ye,low Gets the system-defined color that has an ARGB value of #FFFFFF00. 

YellowGreen Gets the system-defined color that has an ARGB value of #FF9ACD32. 

The "Avalon" color names match the Microsoft® .NET Framework version 1.0, Windows Forms and 
Microsoft Internet Explorer color names. This representation is based on UNIX X1 1 named color values 
Color names are not case-sensitive. 
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The following color table image shows a color swatch for each of the named colors along with the 
corresponding color name, hexadecimal value, and RGB value that you can use to render an area in that 
color. 

This example uses the SolidColorBrush class in "Longhom" markup language (code-named "XAML") to 
color areas such as the window background and the border and interior of shapes. The SolidColorBrush 
creates fills that are uniform in color— it can't create gradient or pattern fills. SolidColorBrush uses both 
predefined color values and hexadecimal color values. In this example, several Ellipse shapes are 
created with identical fills and outlines, but the fills and outlines are specified in different formats to 
demonstrate the versatility of the SolidColorBrush class. 

In the following markup, a Canvas element is declared and its Background property is set to LiqhtGrav 
one of the predefined colors. ~ 

<Canvas ID="root" xmlns="http://schemas.microsoft.com/2003/xaml" 
Background="LightGray"> 

In the next example, the Fill and Stroke properties of an Ellipse are set using ARGB notation ARGB 
consists of a pound sign (#) and eight digits. The pound sign indicates that the digits that follow are in 
hexidecimal (base-16) format. The first two digits specify the alpha value, or opacity of the color FF 
indicates a color that is fully opaque, while 00 indicates a color that is completely transparent The next 
six digits of the number specify the red, green, and blue values of the color. 

The fill of the Ellipse is set to #FFFFFF00, which specifies a color that is fully opaque (FF) has the 
maximum amount of red (FF), the maximum amount of green (FF), and no blue(OO). This combination 
produces yellow. 

<Eliipse 
Fill="#FFFFFFO0" 
CenterX="100" 
CenterY="200" 
RadiusX="75" 
RadiusY="75" 
StrokeThickness="5" 
Stroke="#FF0000FF'7> 

In the next example, the Fill and Stroke properties of an Ellipse are set using shorter hexidecimal 
notation. The alpha value is omitted, and one digit is used for each red, green, and blue value instead of 
two. The resulting Ellipse has colors identical to the first. 

<Ellipse 
Fill="#FF0" 
CenterX="200" 
CenterY="200" 
RadiusX="75" 
RadiusY="75" 
StrokeThickness="5" 
Stroke="#00F'7> 

In the next example, the Fill and Stroke properties of an Ellipse are set using two of the predefined colors 
Yellow and Blue. The resulting Ellipse has colors identical to the previous two. 

<Ellipse 
Fill="Yellow" 
CenterX="300" 
CenterY="200" 
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RadiusX="75" 
RadiusY="75" 
StrokeThickness= M 5" 
Stroke= M Blue , 7> 

In the final example, the Fill property of a Polyline is set by explicitly declaring a SolidColorBrush. The 
Color property of the SolidColorBrush is set to Blue, and its Opacity property is set to 0.4, creating a fill 
that is blue and 40 percent opaque (or 60 percent translucent). 

<Polyiine 

Points="300,200 400,125 400,275 300,200" 

Stroke="Purple" 

StrokeThickness="2.3 M > 

<Polyline.Fill> 

<SolidColorBrush Color="Blue" Opacity="0.47> 
</Polyline.Fill> 

</Polyline> 

</Canvas> 

This example demonstrates several equivalent ways to specify color values to fill an area using code. The 
simplest syntax uses a named color property from the Brushes class. The Colors class provides the same 
named color properties which you can pass as an argument to SolidColorBrush. The example also shows 
how to pass Color values to SolidColorBrush as separate alpha, red, green, and blue values using the 
Color structure's static FromScRGB method. The example draws identical Ellipse shapes using identical 
colors specified in these different ways. 

//C# 

// Create the ellipses. 
Ellipse e1 = new Ellipse(); 
Ellipse e2 = new Ellipse(); 
Ellipse e3 = new Ellipse(); 

// Set the fill value for the interior of each ellipse in 

// different ways that have identical results. 

el.Fill = Brushes.Blue; 

e2.Fill = new SolidColorBrush(Colors.Blue); 

e3.Fill = new SolidColorBrush(Color.FromScRGB( 1,0,0,1)); 

// Set the stroke value for the interior of each ellipse in 

// different ways that have identical results. 

e1 .Stroke = Brushes. Black; 

e2.Stroke = new SolidColorBrush(Colors. Black); 

e3.Stroke = new SolidColorBrush(Color.FromScRGB(1, 0,0,0)); 



This sample demonstrates only a few of the ways to instantiate Color objects. See Color for more 
information. 

In order to actually render the ellipse the example also sets values for the StrokeThickness, CenterX, 
CenterY, RadiusX, and RadiusY properties in order to set the size and position of each ellipse. 

//C# 

// Set the thickness of the stroke. 

e1. StrokeThickness = new Length(10); 
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e2.StrokeThickness = new Length(10); 
e3.StrokeThickness = new Length(10); 

// Set the size and position of the ellipses. 
e1 .CenterX = new Length(1 00); 
el.CenterY = new Length(75); 
elRadiusX = new Length(50); 
elRadiusY = new Length(50); 

e2. CenterX = new Length(220); 
e2.CenterY = new Length(75); 
e2.RadiusX = new Length(50); 
e2.RadiusY = new Length(50); 

e3.CenterX = new Length(340); 
e3.CenterY = new Length(75); 
e3.RadiusX = new Length(50); 
e3.RadiusY = new Length(50); 



ContainerVisual Class 

Definition: Manages a collection of Visual objects. 



Method 

ClearValue 

ContainerVisual 

Equals 

Finalize 

FindCommonVisualAncestor 
GetHashCode 

GetLocalValueEnumerator 

Getfype 
GetValue 

HitTest 

HitTestCore 

InvalidateProperty 

IsAncestorOf 

IsDescendantOf 

IVisual.FindCommonVisualAncestor 
I Visual. HitTest 



Description 

Clears the local value of a property Inherited from 
DependencyObject. 

Creates a new instance of the ContainerVisual class. 

Determines whether two Object instances are equal. Inherited from 
Object. 

Releases all resources held by the Visual object Inherited from 
Visual. 

Re-exposes the Visual base class's corresponding IVisual 
implementation as public method. 

Serves as a hash function for a particular type, suitable for use in 
hashing algorithms and data structures like a hash table. Inherited 
from Object. 

Create a local value enumerator for this instance Inherited from 
DependencyObject. 

Gets the Type of the current instance. Inherited from Object. 
Retrieve the value of a property Inherited from DependencyObject. 
Re-exposes the Visual base class's corresponding IVisual 
implementation as public method. 

HitTestCore implements whether we have hit the bounds of this 
visual. Inherited from Visual. 

Invalidates a property Inherited from DependencyObject. 
Re-exposes the Visual base class's corresponding IVisual 
implementation as public method. 

Re-exposes the Visual base class's corresponding IVisual 
implementation as public method. 

Inherited from Visual. 

Inherited from Visual. 
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IVisual.lsAncestorOf 

IVisual. IsDescendantOf 

IVisualTransformFromAncestor 

IVisual.TransformFromDescendant 

IVisualTransformFromVisuai 

IVisual.TransformToAncestor 

IVisual.TransformToDescendant 

IVisual.TransformToVisual 

MemberwiseClone 

OnDelayedlnvalidate 

OnPropertylnvalidated 

ReadLocalValue 

ReferenceEquals 

SetContext 

SetValue 

ToString 

Transform From Ancestor 
TransformFromDescendant 
TransformFrom Visual 

TransformToAncestor 

TransformToDescendant 

TransformToVisual 

ValidateProperty 

ValidatePropertyCore 



Inherited from Visual. 
Inherited from Visual. 
Inherited from Visual. 
Inherited from Visual. 
Inherited from Visual. 
Inherited from Visual. 
Inherited from Visual. 
Inherited from Visual. 

Creates a shallow copy of the current Object. Inherited from Object. 
TODO: Left over from WCP FastBuild, determine relevance in 
future version of FastBuild Inherited from DependencyObject. 

Notification that a specified property has been invalidated Inherited 
from DependencyObject. 

Retrieve the local value of a property (if set) Inherited from 
DependencyObject. 

Determines whether the specified Object instances are the same 
instance. Inherited from Object. 

Associates this UlContextObject with a UlContext. Inherited from 
UlContextObject. 

Sets the local value of a property Inherited from 
DependencyObject. 

Returns a String that represents the current Object. Inherited from 
Object. 

Re-exposes the Visual base class's corresponding IVisual 
implementation as public method. 

Re-exposes the Visual base class's corresponding IVisual 
implementation as public method. 

Re-exposes the Visual base class's corresponding IVisual 
implementation as public method. 

Returns a Matrix object that represents the aggregate 
transformation from the coordinates of a Visual to the specified 
ancestor. 

Returns a transformation matrix that can be used to transform 
coordinates from this node to a specified descendant Visual. 

Re-exposes the Visual base class's corresponding IVisual 
implementation as public method. 

Retrieve the value of a property (for use by native cache backed 
custom get accessors) Inherited from DependencyObject. 
Allows subclasses to participate in property value 
computation Inherited from DependencyObject. 



Property 

Children 
Clip 

Context 



Description 

Gets a collection of the ContainerVisual's children. 

Gets or sets the clipping region of this ContainerVisual. 

Returns the UlContext that this UlContextObject is associated with. Inherited 
from UlContextObject. 

DependencvObiectTvoe Returns the D1 ~yP e that represents the CLR type of this instance Inherited from 
y J yH DependencyObject. 
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HasChildren 
HitTestBounds 

IsOisposed 

Opacity 
Parent 



Gets a value that indicates whether the ContainerVisual has a child collection. 

HitBounds returns the hit region bounding box for the current visual. Inherited 
from Visual. 

Gets a value that indicates whether the system has disposed of the 
Visual. Inherited from Visual. 

Gets or sets the opacity of the ContainerVisual. 

Gets the parent Visual. 



DashArrays Class 

Definition: DashArrays - The DashArrays class is static, and contains properties for well known dash 
styles. 



Method Description 

Equals Determines whether two Object instances are equal. Inherited from Object. 

Finalize Allows an Object to attempt to free resources and perform other cleanup operations 

before the Object is reclaimed by garbage collection. Inherited from Object. 

GetHashCode Serves as a hash function for a particular type, suitable for use in hashing algorithms 

and data structures like a hash table. Inherited from Object. 
GetType Gets the Type of the current instance. Inherited from Object. 

MemberwiseClone Creates a shallow copy of the current Object. Inherited from Object. 

ReferenceEauals Determines whether the specified Object instances are the same instance. Inherited 
H from Object. 



ToString 



Returns a String that represents the current Object. Inherited from Object. 



Property Description 

Dash Dash - A DashArray which is 3 on, 1 off 

DashDot DashDot - A DashArray which is 3 on, 1 off, 1 on, 1 off 

DashDotDot DashDot - A DashArray which is 3 on, 1 off, 1 on, 1 off, 1 on, 1 off 

Dot Dot - A DashArray which is 1 on, 1 off 

Solid Solid - A solid DashArray (no dashes). 



DoubieCollection Class 



Method 



Description 



Add 
AddRange 
Clear 
CloneCore 

CloneDownToUnchanqeable Returns an immutable copy of the specified object. Inherited from 
* Changeable. 

Contains 



Copy 

Copy 
CopyTo 



Returns a modifiable copy of the current object. The copy's 
IsChangeable property is true and its StatusOfNextUse is 
Unchangeable. Inherited from Changeable. 

Copies the entire DoubieCollection to a compatible one-dimensional 
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DoubleCollection 



EmbeddedChangeableReader 



EmbeddedChangeableWriter 
Equals 

Finalize 

GetEnumerator 

GetHashCode 

GetRange 
GetType 

lAddChild.AddChiid 

lAddChild.AddText 

IList.Add 

IList.Contains 

IList.lndexOf 

I List. Insert 

I List. Remove 

IndexOf 

Insert 

InsertRange 
LastlndexOf 

MakeUnchangeable 

MakeUnchangeableCore 
MemberwiseClone 



ModifyHandlerlfChangeable 



OnChanged 



PropagateEventHandler 



ReadPreamble 



Array, starting at the specified index of the target array. 

Accesses the specified Changeable data member, processes it, and 
returns a reference to the member. This reference should then be 
reassigned to the original member variable. Classes that derive from 
Changeable call this method on data members before they can be 
retrieved through property calls. Inherited from Changeable. 
Processes a modified Changeable data member and returns a 
reference to the processed object. Inherited from Changeable. 

Determines whether two Object instances are equal. Inherited from 
Object. 

Allows an Object to attempt to free resources and perform other cleanup 
operations before the Object is reclaimed by garbage 
collection. Inherited from Object. 

Serves as a hash function for a particular type, suitable for use in 
hashing algorithms and data structures like a hash table. Inherited from 
Object. 

Gets the Type of the current instance. Inherited from Object. 



Makes an object immutable; after this method is called on a 
Changeable, its IsChangeable property is false. Inherited from 
Changeable. 

Makes a Changeable object immutable. Inherited from Changeable. 
Creates a shallow copy of the current Object Inherited from Object. 
Adds or removes a Changed event handler to or from the specified 
Changeable object, if the object is currently modifiable. If the specified 
object is not modifiable— if its IsChangeable property is false— this 
method has no effect. Inherited from Changeable. 
Called when the current object is modified. Classes that derive from 
Changed should call this method after they have been 
modified. Inherited from Changeable. 

Shares a Changed event handler with the current object's data 
members or removes it. Inherited from Changeable. 
Ensures that simple (non-Changeable) members are being accessed 
from a valid Ul context. This method should be called before any simple 
members are accessed. Inherited from Changeable. 
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ReferenceEquals 

Remove 
RemoveAt 
RemoveRange 
SetRange 

ToString 



ValidateObjectState 
WritePostscript 

WritePreamble 



Determines whether the specified Object instances are the same 
instance. Inherited from Object. 



Returns a String that represents the current Object Inherited from 
Object 

Verifies that the current object has a valid state. If the object is in an 
invalid state, this method throws an exception. Inherited from 
Changeable. 

Causes the current object to validate itself and then invokes the 
OnChanged method. Inherited from Changeable. 
Ensures that simple (non-Changeable) members are being accessed 
from a valid user interface (Ul) context. This method should be called 
before any simple members are set. Inherited from Changeable. 



Property 



Description 

Used in conjunction with the ChangeableUsageOverride type sent in 
AllowChangeableReferenceOverride as a P arameter to ChangeableHelper.UseChangeable, to help 

determine when a Changeable being put into "use" should be 
promoted to "ChangeableReference". Inherited from Changeable. 

True if this Changeable can be made unchangeable. Inherited from 
Changeable. 



CanMakeUnchangeable 



Capacity 
Count 

IsChangeable 

IsFixedSize 
Item 



StatusOfNextUse 



UlContext 



Gets a Boolean that indicates whether the object is currently 
modifiable. Inherited from Changeable. 



Gets or sets a UseStatus enumeration that specifies how the 
Changeable object behaves when it is "used." A Changeable object 
is considered used in the following situations: the object is set into a 
Property System property, the object is used as a sub-object in a 
complex Changeable object, or the object is used in a 
DrawingContext command. Inherited from Changeable. 
Gets the UlContext of the current object. The UlContext is used for 
maintaining thread safety. Inherited from Changeable. 



DoubleCollectionConverter Class 

Definition. DoubleCollectionConverter - Converter class for converting instances of other types to and 
from DoubleCollection instances. 

Method Description 

CanConvertFrom CanConvertFrom - Returns whether or not this class can convert from a 

given type. 

CanConvertFrom Inherited from TypeConverter. 

CanConyertTo Inherited from TypeConverter. 
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CanConvertTo 

ConvertFrom 

ConvertFrom 

ConvertFromlnvariantString 

ConvertFromString 

ConvertTo 

ConvertTo 

ConvertTolnvariantString 
ConvertToString 
Createlnstance 
DoubleCollectionConverter 

Equals 
Finalize 

GetConvertFromException 

GetConvertToException 

GetCreatelnstanceSupported 

GetHashCode 

GetProperties 

GetPropertiesSupported 

GetStandardValues 

GetStandardValuesExclusive 

GetStandardValuesSupported 

GetType 

IsValid 

MemberwiseClone 

ReferenceEquals 

SortProperties 
ToString 



CanConvertTo - Returns whether or not this class can convert to a given 
type. 

Inherited from TypeConverter. 

ConvertFrom - Attempt to convert to a DoubleCollection from the given 
object 

Inherited from TypeConverter. 
Inherited from TypeConverter. 
Inherited from TypeConverter. 

ConvertTo - Attempt to convert a DoubleCollection to the given type 
Inherited from TypeConverter. 
Inherited from TypeConverter. 
Inherited from TypeConverter. 

Determines whether two Object instances are equal. Inherited from 
Object. 

Allows an Object to attempt to free resources and perform other cleanup 
operations before the Object is reclaimed by garbage collection. Inherited 
from Object. 

Inherited from TypeConverter. 
Inherited from TypeConverter. 
Inherited from TypeConverter. 

Serves as a hash function for a particular type, suitable for use in hashing 
algorithms and data structures like a hash table. Inherited from Object. 

Inherited from TypeConverter. 

Inherited from TypeConverter. 

Inherited from TypeConverter. 

Inherited from TypeConverter. 

Inherited from TypeConverter. 

Gets the Type of the current instance. Inherited from Object. 
Inherited from TypeConverter. 

Creates a shallow copy of the current Object. Inherited from Object. 
Determines whether the specified Object instances are the same 
instance. Inherited from Object. 

Inherited from TypeConverter. 

Returns a String that represents the cu rrent Object. Inherited from Object. 



Drawing Class 

Definition: A Drawing is a list of 2d drawing primitives. 



Method 



CloneCore 



CloneDownToUnchangeable 



Copy 



Description 

CloneCore - the internal implementation of the Changeable clone. 

Returns an immutable copy of the specified object. Inherited from 
Changeable 

Returns a modifiable copy of the current object. The copy's 
IsChangeable property is true and its StatusOfNextUse is 
Unchangeable. Inherited from Changeable. 
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Copy Make a copy of this Changeable 

Drawing Constructor for Drawing. This initializes to empty. 

Accesses the specified Changeable data member, processes it, and 
returns a reference to the member. This reference should then be 
EmbeddedChangeableReader reassigned to the original member variable. Classes that derive from 

Changeable call this method on data members before they can be 
retrieved through property calls. Inherited from Changeable. 
Processes a modified Changeable data member and returns a 
reference to the processed object. Inherited from Changeable. 

Determines whether two Object instances are equal. Inherited from 
Object. 

Finalizer for Drawing 

Serves as a hash function for a particular type, suitable for use in 
hashing algorithms and data structures like a hash table. Inherited from 
Object. 

Gets the Type of the current instance. Inherited from Object. 



EmbeddedChangeableWriter 

Equals 
Finalize 

GetHashCode 



GetType 
lAddChild.AddChild 
lAddChild.AddText 

MakeUnchangeable 

MakeUnchangeableCore 
MemberwiseClone 

ModifyHandlerlfChangeable 

OnChanged 
Open 

PropagateEventHandler 

ReadPreamble 

ReferenceEquals 
ToString 

ValidateObjectState 

WritePostscript 

WritePreamble 



Makes an object immutable; after this method is called on a 
Changeable, its IsChangeable property is false. Inherited from 
Changeable. 

MakeUnchangeableCore - the internal implementation of the code 
which makes this instance immutable. 

Creates a shallow copy of the current Object. Inherited from Object. 
Adds or removes a Changed event handler to or from the specified 
Changeable object, if the object is currently modifiable. If the specified 
object is not modifiable— if its IsChangeable property is false— this 
method has no effect. Inherited from Changeable. 
Called when the current object is modified. Classes that derive from 
Changed should call this method after they have been 
modified. Inherited from Changeable. 

Opens the Drawing for rendering. The returned DrawingContext can be 
used to render into the Drawing. 

Shares a Changed event handler with the current object's data 
members or removes it. Inherited from Changeable. 
Ensures that simple (non-Changeable) members are being accessed 
from a valid user interface (Ul) context. This method should be called 
before any simple members are accessed. Inherited from Changeable. 
Determines whether the specified Object instances are the same 
instance. Inherited from Object. 

Returns a String that represents the current Object. Inherited from 
Object. 

Verifies that the current object has a valid state. If the object is in an 
invalid state, this method throws an exception. Inherited from 
Changeable. 

Causes the current object to validate itself and then invokes the 
OnChanged method. Inherited from Changeable. 

Ensures that simple (non-Changeable) members are being accessed 
from a valid Ul context. This method should be called before any simple 
members are set. Inherited from Changeable. 



59 



Pr perty Descripti n 

Used in conjunction with the ChangeableUsageOverride type sent in 

AllowChangeableReferenceOverride as a P arametert <> ChangeableHelper.UseChangeable, to help 

determine when a Changeable being put into "use" should be 
promoted to "ChangeableReference" Inherited from Changeable. 

Bounds Bounds Property - The bounds of the contents. 

True if this Changeable can be made unchangeable. Inherited from 
Changeable. 

Gets a Boolean that indicates whether the object is currently 
modifiable. Inherited from Changeable. 

Gets or sets a UseStatus enumeration that specifies how the 
Changeable object behaves when it is "used." A Changeable object 
is considered used in the following situations: the object is set into a 
Property System property, the object is used as a sub-object in a 
complex Changeable object, or the object is used in a 
DrawingContext command. Inherited from Changeable. 

Gets the UlContext of the current object. The UlContext is used for 
maintaining thread safety. Inherited from Changeable. 



CanMakeUnchangeable 
IsChangeable 



StatusOfNextUse 



UlContext 



DrawingBrush Class 

Definition: DrawingBrush - This TileBrush defines its content as a Drawing. 



Method 

CloneCore 
CloneCore 

CloneDownToUnchangeable 
Copy 



Copy 

Copy 
Copy 

DeserializeFrom 
DisableCore 
DrawingBrush 

EmbeddedAnimationCollectionReader 

EmbeddedAnimationCollectionWriter 

EmbeddedChangeableReader 



Description 

Returns a modifiable shallow or deep clone of the current object. 
This abstract method must be implemented by classes that 
derive from Changeable. Inherited from Changeable. 

Returns an immutable copy of the specified object Inherited from 
Changeable. 

Creates a copy of this TileBrush. Inherited from TileBrush. 

Returns a modifiable copy of the brush. The copy's IsChangeable 
property is true and its StatusOfNextUse is 
Unchangeable. Inherited from Brush. 

Returns a modifiable copy of the current object. The copy's 
IsChangeable property is true and its StatusOfNextUse is 
Unchangeable. Inherited from Changeable. 
Creates a copy of this DrawingBrush. 

Returns a new Brush initialized from the binary representation 
being read by the passed BinaryReader. Inherited from Brush. 
Inherited from Brush. 

Default constructor for DrawingBrush. The resulting Brush has no 
content. 

Maybe this should be internal?? Inherited from Animatable. 
Inherited from Animatable. 
Inherited from Animatable. 
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EmbeddedChangeableWriter 
EnableCore 

Equals 

Finalize 

GetCurrentValue 
GetCurrentValue 

GetCurrentValue 

GetCurrentValue 
GetHasAnimations 

GetHashCode 

GetisAnimating 

GetlsOverridingBaseValue 

GetType 

MakeUnchangeable 

MakeUnchangeableCore 
MemberwiseClone 

ModifyHandlerlfChangeable 
OnChanged 

PropagateEventHandler 
ReadPreambie 

ReferenceEquals 
SerializeOn 

SetDefaultParentTimeline 
SetDefaultParentTimeline 



Inherited from Animatable. 
Inherited from Brush. 

Determines whether two Object instances are equal. Inherited 
from Object. 

Inherited from Brush. 

Returns a non-animated version of this DrawingBrush that 
represents its current state. 

Returns the current value of the brush. The returned brush has 
the same value as the current object, but doesn't vary over time; 
that is, the returned brush is a snapshot of the current object at 
the point in time at which this method was called. Inherited from 
Brush. 

Returns a non-animated version of this TileBrush that represents 
its current state. Inherited from TileBrush. 

Returns a non-animated version of this Animatable that 
represents its current state. Inherited from Animatable. 
Inherited from Brush. 

Serves as a hash function for a particular type, suitable for use in 
hashing algorithms and data structures like a hash 
table. Inherited from Object. 

Inherited from Brush. 

Inherited from Brush. 

Gets the Type of the current instance. Inherited from Object. 
Makes an object immutable; after this method is called on a 
Changeable, its IsChangeable property is false. Inherited from 
Changeable. 

Creates a shallow copy of the current Object. Inherited from 
Object. 

Adds or removes a Changed event handler to or from the 
specified Changeable object, if the object is currently modifiable. 
If the specified object is not modifiable— if its IsChangeable 
property is false— this method has no effect. Inherited from 
Changeable. 

Called when the current object is modified. Classes that derive 
from Changed should call this method after they have been 
modified. Inherited from Changeable. 

Ensures that simple (non-Changeable) members are being 
accessed from a valid Ul context. This method should be called 
before any simple members are accessed. Inherited from 
Changeable. 

Determines whether the specified Object instances are the same 
instance. Inherited from Object. 

Serialize this object using the passed writer Inherited from Brush. 
Inherited from Brush. 

This will change the time parent for animations on any of the 
properties of this Changeable which are inheriting their time 
parent. Inherited from Animatable. 
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SetDefaultParentTimelineCore 
ToString 

ValidateObjectState 
WritePostscript 

WritePreamble 



Inherited from Brush. 

Returns a String that represents the current Object. Inherited 
from Object. 

Verifies that the current object has a valid state. If the object is in 
an invalid state, this method throws an exception. Inherited from 
Changeable. 

Causes the current object to validate itself and then invokes the 
OnChanged method. Inherited from Changeable. 
Ensures that simple (non-Changeable) members are being 
accessed from a valid user interface (Ul) context. This method 
should be called before any simple members are set. Inherited 
from Changeable. 



Property 



Description 

Used in conjunction with the ChangeableUsageOverride type sent in 
AllowChangeableReferenceOverride as a P arameter to ChangeableHelper.UseChangeable, to help 

determine when a Changeable being put into "use" should be 
promoted to "ChangeableReference". Inherited from Changeable. 

True if this Changeable can be made unchangeable. Inherited from 
Changeable. 

Gets or sets a BrushMappingMode enumeration that specifies 
whether the value of the brush's ViewBox— the size and position of 
the brush's content— is relative to the size of the output area. This 
property only has an effect when the size of the brush's ViewPort is 
set to RectEmpty. Inherited from TileBrush. 
The current parent Timeline associated with this Animatable. This 
will be the Timeline set to the ParentTimeline property of this 
Animatable if one has been set and if not, the Timeline last passed 
into the SetDefaultParentTimeline method. Inherited from 
Animatable. 



CanMakeUnchangeable 



ContentUnits 



DefaultParentTimeline 



Drawing 
HasAnimations 

HorizontalAlignment 

IsAnimating 

IsChangeable 

IsOverridingBaseValue 
Opacity 

OpacityAn inflations 



StatusOfNextUse 



Drawing - Read Only accessor for the Drawing which describes the 
contents of this brush. Default is null. 

Gets a Boolean that indicates whether the brush has 
animations. Inherited from TileBrush. 

Gets or sets a HorizontalAlignment enumeration that specifies how 
the brush's content is horizontally aligned within its tiles. Inherited 
from TileBrush. 

Inherited from TileBrush. 

Gets a Boolean that indicates whether the object is currently 
modifiable. Inherited from Changeable. 
Inherited from TileBrush. 

Gets or sets the degree of opacity of a Brush. Inherited from Brush. 
Gets or sets the animations associated with the Opacity of the 
brush. Inherited from Brush. 

Gets or sets a UseStatus enumeration that specifies how the 
Changeable object behaves when it is "used." A Changeable object 
is considered used in the following situations: the object is set into a 
Property System property, the object is used as a sub-object in a 
complex Changeable object, or the object is used in a 
DrawingContext command. Inherited from Changeable. 
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Stretch 

TileMode 

Transform 

UlContext 

VerticalAlignment 

ViewBox 

ViewBoxAnimations 
ViewPort 

ViewPortAnimations 
ViewPortUnits 



Gets or sets a Stretch enumeration that specifies how the brush's 
selected content (ViewBox) is displayed in the brush's tiles 
(ViewPort). Inherited from TileBrush. 

Gets or sets a TileMode structure that specifies how the brush's tiles 
fill the output area. Inherited from TileBrush. 
Gets or sets a transformation that is applied to the brush. This 
transformation is applied after all other mapping and positioning 
have been processed. Inherited from Brush. 

Gets the UlContext of the current object. The UlContext is used for 

maintaining thread safety. Inherited from Changeable. 

Gets or sets a VerticalAlignment enumeration that specifies how the 

brush's content is vertically aligned within its tiles. Inherited from 

TileBrush. 

Gets or sets the position and dimensions of the brush's 
content. Inherited from TileBrush. 

Gets or sets a collection of RectModifier objects that animate the 
ViewBox of the brush. Inherited from TileBrush. 

Gets or sets the position and dimensions of the brush's 
tiles. Inherited from TileBrush. 

Gets or sets a collection of RectModifier objects that animate the 
ViewPort of the brush. Inherited from TileBrush. 
Gets or sets a BrushMappingMode enumeration that specifies 
whether the value of the brush's ViewPort— the size and position of 
the brush's tiles— is relative to the size of the output area Inherited 
from TileBrush. 



DrawingContext Class 

Definition: Drawing context. 

Method 

Close 
Dispose 

DrawDrawing 

DrawEllipse 

DrawGeometry 
DrawGlyphs 

Drawlmage 
DrawLine 



Description 

Closes the DrawingContext and flushes the content. Afterwards the 
DrawingContext can not be used anymore. This call does not require all 
Push calls to have been Popped. 

This is the same as the Close call: Closes the DrawingContext and 
flushes the content. Afterwards the DrawingContext can not be used 
anymore. This call does not require all Push calls to have been Popped. 
Draw a Drawing at the location specified by the Point. For more fine 
grained control, consider filling a Rect with an RenderDataBrush via 
DrawRect. 

Draw an ellipse with the provided Brush and/or Pen. If both the Brush 
and Pen are null this call is a no-op. 

Draw a Geometry with the provided Brush and/or Pen. If both the Brush 
and Pen are null this call is a no-op. 
Draw a GlyphRun. 

Draw an Image into the region specified by the Rect. The Image will 
potentially be stretched and distorted to fit the Rect. For more fine 
grained control, consider filling a Rect with an ImageBrush via 
DrawRect. 

Draws a line with the specified pen. Note that this API does not accept a 
Brush, as there is no area to fill. 
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DrawRectangle 

DrawRoundedRectangle 

DrawSubLineCollection 
DrawText 



DrawVideo 

Equals 
Finalize 

GetHashCode 
GetType 

MemberwiseClone 
Pop 

PushClip 

PushOpacity 

PushTransform 

ReferenceEquals 

SetContext 

ToString 

VerifyAPI NonStructuralChange 



Draw a rectangle with the provided Brush and/or Pen. If both the Brush 
and Pen are null this call is a no-op. 

Draw a rounded rectangle with the provided Brush and/or Pen. If both 

the Brush and Pen are null this call is a no-op. 

Draw a SubLineCollection. 

Draw Text at the location specified. 

Draw an Video into the region specified by the Rect. The Video will 
potentially be stretched and distorted to fit the Rect. For more fine 
grained control, consider filling a Rect with an VideoBrush via 
DrawRect. 

Determines whether two Object instances are equal. Inherited from 
Object. 

Allows an Object to attempt to free resources and perform other 
cleanup operations before the Object is reclaimed by garbage 
collection. Inherited from Object. 

Serves as a hash function for a particular type, suitable for use in 
hashing algorithms and data structures like a hash table. Inherited from 
Object. 

Gets the Type of the current instance. Inherited from Object. 
Creates a shallow copy of the current Object. Inherited from Object. 
Pop the most recent Push operation, which may have been a Clip 
Opacity, Transform, etc. 

Push a clip region, which will apply to all drawing primitives until the 
corresponding Pop call. 

Push an opacity which will blend the composite of all drawing primitives 
added until the corresponding Pop call. 

Push a Transform which will apply to all drawing operations until the 
corresponding Pop. 

Determines whether the specified Object instances are the same 
instance. Inherited from Object. 

Associates this UlContextObject with a UlContext. Inherited from 
UlContextObject. 

Returns a String that represents the current Object. Inherited from 
Object 

This verifies that the API can be called for read only access. 



Property 



Description 



Context *fi ums the u,Cont ext that this UlContextObject is associated with. Inherited from 
UlContextObject. 

The following example shows the simplest way to draw text to a visual in C#. The DrawText method is 
used to pass FormattedText to the DrawingContext object. The DrawingContext is later drawn to the 
screen using the RenderOpen method of the DrawingVisual object. 

[C#] 

using System; 

using MSAvalon.Windows; 

using MSAvalon.Windows.Controls; 

using MSAvalon.Windows.Media; 
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namespace DrawText_Demo 
{ 

public class MyApp : MSAvalon.Windows.Application 

MSAvalon.Windows. Media. DrawingContext myDrawingContext; 
MSAvalon. Windows. Media. DrawingVisual myDrawingVisual; 
MSAvalon.Windows.Window mainWindow; 

protected override void OnStartingUp (StartingUpCancelEventArgs e) 

base.OnStartingUp (e); 
CreateAndShowMainWindow (); 



private void CreateAndShowMainWindow () 

// Create the application's main window 
mainWindow = new MSAvalon.Windows.Window (); 
mainWindow. Show (); 

// Draw the Text 
DrawingVisual myDrawingVisual = new DrawingVisual(); 
DrawingContext myDrawingContext = myDrawingVisual. RenderOpen(); 

myDrawingContext.DrawText(new FormattedTextfHello World!", new 
TypefaceCVerdana"), 14, Brushes.Black), new Point(10, 10)); 

myDrawingContext.Close(); 

((IVisual)mainWindow).Children.Add(myDrawingVisual); 
} } 

internal sealed class EntryClass 
{ 

[System.STAThread()] 
private static void Main () 
{ 

MyApp app = new MyApp (); 
app.Run (); 

} 

} 

} 



This example demonstrates how to draw using a DrawingVisual. There are two ways to use a 
DrawingVisual: create a class that derives from DrawingVisual, or create a new instance of the 
DrawingVisual class and use its RenderOpen method to obtain a DrawingContext. The latter method is 
demonstrated in this example. 

In the following example, a DrawingVisual is created and used to draw an ellipse. 
//C# 

Window mainWindow = new MSAvalon.Windows.Window(); 
mainWindow.ShowQ; 
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DrawingVisual myDrawingVisual = new DrawingVisual(); 
DrawingContext myDrawingContext = myDrawingVisual. RenderOpen(); 

SolidColorBrush mySolidColorBrush = new SolidColorBrush(); 
mySolidColorBrush. Color = Colors.Red; 
Pen myPen = new Pen(Brushes.Blue, 10); 

EllipseGeometry aGeometry = new EllipseGeometry(new Point(200,200), 100, 50); 
myDrawingContext. DrawGeometry(Brushes.LimeGreen, myPen, aGeometry); 
myDrawingContext.Close(); 

((IVisual)mainWindow).Children.Add(myDrawingVisual); 



' VB NET 

main Window. Show() 

Dim myDrawingVisual As new MSAvalon.Windows.Media.DrawingVisual 
Dim myDrawingContext = myDrawingVisual. RenderOpen() 

Dim mySolidColorBrush As new MSAvalon.Windows.Media.SolidColorBrush 
mySolidColorBrush.Color = Colors.Red 

Dim my Pen As new MS Avalon. Windows. Media. Pen( _ 
MSAvalon. Windows. Media. Brushes. Blue, 10) 

Dim aGeometry As new MSAvalon. Windows.Media.EllipseGeometry( _ 
new MSAvalon. Windows. Point(200,200), 100, 50) 

myDrawingContext. DrawGeometry( _ 

MSAvalon.Windows.Media.Brushes.Blue, myPen, aGeometry) 
myDrawingContext.CloseO 

CType(mainWindow, MSAvalon.Windows.Media.lVisual).Children.Add(myDrawingVisual) 
It is important to call the Close method of a DrawingContext after using it. 

In the previous example, the application's Window is cast as a IVisual before adding the drawing visual as 
its child. When adding a non-element child to an element, You must cast the element as a IVisual or else 
an exception will be thrown. 

//C# 

((IVisual)mainWindow).Children.Add(myDrawingVisual); 
'VB.NET 

CType(mainWindow, MSAvalon.Windows.Media.lVisual).Children.Add(myDrawingVisual) 
DrawingVisual Class 

Definition: Visual that contains graphical content to be drawn. 

Method Description 

ClearValue Clears the local value of a property Inherited from 
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DrawingVisual 
Equals 

Finalize 

FindCommonVisualAncestor 
GetHashCode 

GetLocalValueEnumerator 

GetType 
GetValue 

HitTest 

HitTestCore 
InvalidateProperty 

IsAncestorOf 
IsDescendantOf 

IVisual.FindCommonVisualAncestor 
IVisual. HitTest 
IVisual. IsAncestorOf 
IVisual. IsDescendantOf 
IVisualTransformFromAncestor 
IVisual. TransformFromDescendant 
IVisual.TransformFromVisual 
IVisual.TransformToAncestor 
IVisualTransformToDescendant 
IVisual.TransformToVisual 
MemberwiseClone 

OnDelayedlnvalidate 

OnPropertylnvalidated 

Read Local Value 

ReferenceEquals 

RenderOpen 

SetContext 
SetValue 



DependencyObject 

Initializes a new instance of the DrawingVisual class. 

Determines whether two Object instances are equal. Inherited from 
Object. 

Releases all resources held by the Visual object. Inherited from 
Visual. 

Re-exposes the Visual base class's corresponding IVisual 
implementation as public method. 

Serves as a hash function for a particular type, suitable for use in 
hashing algorithms and data structures like a hash table. Inherited 
from Object. 

Create a local value enumerator for this instance Inherited from 
DependencyObject. 

Gets the Type of the current instance. Inherited from Object. 

Retrieve the value of a property Inherited from DependencyObject. 

Re-exposes the Visual base class's corresponding IVisual 
implementation as public method. 

HitTestCore implements precise hit testing against render contents 

Invalidates a property Inherited from DependencyObject. 

Re-exposes the Visual base class's corresponding IVisual 
implementation as public method. 

Re-exposes the Visual base class's corresponding IVisual 
implementation as public method. 

Inherited from Visual. 

Inherited from Visual. 

Inherited from Visual. 

Inherited from Visual. 

Inherited from Visual. 

Inherited from Visual. 

Inherited from Visual. 

Inherited from Visual. 

Inherited from Visual. 

Inherited from Visual. 

Creates a shallow copy of the current Object. Inherited from Object. 
TODO: Left over from WCP FastBuild, determine relevance in 
future version of FastBuild Inherited from DependencyObject. 

Notification that a specified property has been invalidated Inherited 
from DependencyObject. 

Retrieve the local value of a property (if set) Inherited from 
DependencyObject. 

Determines whether the specified Object instances are the same 
instance. Inherited from Object. 

Opens the DrawingVisual for rendering. The returned 
DrawingContext can be used to render into the DrawingVisual. 

Associates this UlContextObject with a UlContext. Inherited from 
UlContextObject. 

Sets the local value of a property Inherited from 
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ToString 

TransformFromAncestor 

TransformFromDescendant 

TransformFromVisual 

TransformToAncestor 

TransformToDescendant 

TransformToVisual 

ValidateProperty 

ValidatePropertyCore 



DependencyObject. 

Returns a String that represents the current Object. Inherited from 

Object. 

Re-exposes the Visual base class's corresponding IVisual 
implementation as public method. 

Re-exposes the Visual base class's corresponding IVisual 
implementation as public method. 

Re-exposes the Visual base class's corresponding IVisual 
implementation as public method. 

Returns a transformation matrix that can be used to transform 
coordinates from this node to a specified ancestor Visual. 
Returns a transformation matrix that can be used to transform 
coordinates from this node to a specified descendant Visual. 

Re-exposes the Visual base class's corresponding IVisual 
implementation as public method. 

Retrieve the value of a property (for use by native cache backed 
custom get accessors) Inherited from DependencyObject. 
Allows subclasses to participate in property value 
computation Inherited from DependencyObject. 



Property 

Children 
Clip 

Context 



Description 

Gets a collection of the DrawingVisual's children. 

Gets or sets the clipping region of this DrawingVisual. 

Returns the UlContext that this UlContextObject is associated with. Inherited 
from UlContextObject. 



DependencvObiectTvDe Returns the DT yP e that represents the CLR type of this instance Inherited from 
7 3 yK DependencyObject. 

Gets a value that indicates whether the DrawingVisual has a child collection. 

HitBounds returns the hit region bounding box for the current visual. Inherited 



HasChildren 
HitTestBounds 

IsDisposed 



Opacity 
Parent 



from Visual. 

Gets a value that indicates whether the system has disposed of the 
Visual. Inherited from Visual. 

Gets or sets the opacity of the DrawingVisual. 

Gets the parent DrawingVisual. 



This example demonstrates how to draw using a DrawingVisual. There are two ways to use a 
DrawingVisual: create a class that derives from DrawingVisual, or create a new instance of the 
DrawingVisual class and use its RenderOpen method to obtain a DrawingContext. The latter method is 
demonstrated in this example. 

In the following example, a DrawingVisual is created and used to draw an ellipse. 
//C# 

Window mainWindow = new MSAvalon.Windows.Window(); 
mainWindow.Show(); 

DrawingVisual myDrawingVisual = new DrawingVisual(); 
DrawingContext myDrawingContext = myDrawingVisual.RenderOpen(); 

SolidColorBrush mySolidColorBrush = new SolidColorBrush(); 
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mySolidColorBrush.Color = Colors.Red; 
Pen myPen = new Pen(Brushes.Blue, 10); 

EllipseGeometry aGeometry = new EllipseGeometry(new Point(200,200), 100, 50); 
myDrawingContext.DrawGeometry(Brushes.LimeGreen, myPen, aGeometry)-' 
myDrawingContext.Close(); 

((IVisual)mainWindow).Children.Add(myDrawingVisual); 



1 VB .NET 

mainWindow.Show() 

Dim myDrawingVisual As new MSAvalon.Windows.Media.DrawingVisual 
Dim myDrawingContext = myDrawingVisual. RenderOpen() 

Dim mySolidColorBrush As new MSAvalon.Windows.Media.SolidColorBrush 
mySolidColorBrush.Color = Colors.Red 

Dim myPen As new MSAvalon.Windows.Media.Pen( _ 
MSAvalon.Windows.Media.Brushes.Blue, 10) 

Dim aGeometry As new MSAvalon. Windows. Media. EllipseGeometry( _ 
new MSAvalon. Windows.Point(200,200), 100, 50) 

myDrawingContext. DrawGeometry( _ 

MSAvalon.Windows.Media.Brushes.Blue, myPen, aGeometry) 
myDrawingContext.Close() 

CType(mainWindow, MSAvalon.Windows.Media.lVisual).Children.Add(myDrawingVisual) 
It is important to call the Close method of a DrawingContext after using it. 

In the previous example, the application's Window is cast as a IVisual before adding the drawing visual as 
its child. When adding a non-element child to an element, You must cast the element as a IVisual or else 
an exception will be thrown. 

//C# 

((IVisual)mainWindow).Children.Add(myDrawingVisual); 



1 VB .NET 

CType(mainWindow, MSAvalon.Windows.Media.lVisual).Children.Add(myDrawingVisual) 

This example demonstrates how to use a PrintContext object to write to a printer. 
The following code demonstrates how to print a Visual (the VectorPage in this example) to the default 
printer. The VectorPage in this example derives from DrawingVisual and is used to draw several shap« 
Two VectorPage objects are printed by calling the AddPage method twice 



public static void PrintPaginatedVisualToDefaultPrinter() { 
// create a print context for my default printer 
MSAvalon. Windows.Media. PrintContext pc = 
new MSAvalon. Windows.Media.PrintContext(); 
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// Add two pages to the default rendition 
pc.AddPage(new VectorPage()); 
pc.AddPage(new VectorPageO); 

//Print 
pc.Print(); 

} 



The next example demonstrates how to print a Visual to a printer that the user selects The 
SelectPnntQueue method is used to produce a dialog box that enables the user to select the printer 
number of copies to print, and other options. ' 

[C#] 

public static void PrintPaginatedVisualToSelectedPrinter() { 
// Let user select a printer queue using common dialog box 
System.Printing.PrintSubSystem.PrintQueue queue = 
MSAvalon.Windows.Media.PrintContext.SelectPrintQueue(); 

if (queue != null) { 

// Create MSAvalon.Windows.Media.PrintContext if OK button was clicked 
MSAvalon. Windows. Media. PrintContext pc = 

new MSAvalon.Windows.Media.PrintContext(queue, "Printing Example"); 

//Add a page of visual 
pc.AddPage(new VectorPageO); 



} 



} 



// Print 
pc.PrintO; 



The next example demonstrates how to print to landscape and portrait page orientations. In the following 
code, a JobTicket is obtained and used to set the page orientation. The DimensionPage in this example is 
a DrawingVisual that adjust the size of its drawing to the size of the output page The 
GetPaperWidthHeight method in this example is used to retrieve the page size information from the 
JobTicket. 

[C#] 

public static void MixedOrientationPrint() { 
System. Printing. PrintSubSystem.LocalPrintServer ps = 
new System. Printing. PrintSubSystem.LocalPrintServerO; 

System. Printing. PrintSubSystem.PrintQueue queue = ps.DefaultPrintQueue; 

MSAvalon. Windows. Media. PrintContext pc = 

new MSAvalon.Windows.Media.PrintContext(queue, "Landscape Example"); 

Microsoft. Printing. JobTicket. JobTicket jt = pc. JobTicket; 

// Print a page with landscape orientation. 

jt.PageOrientation. Value = 
System.Printing.Configuration.PrintSchema.OrientationValues.Landscape; 
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double width, height; 

GetPaperWidthHeight(pc.JobTicket, queue, out width, out height); 
// Add a page of visual 

pc.AddPage(new DimensionPage(height, width)); 



// Print a page with portrait orientation. 
{ 

jt.PageOrientation. Value = 
System.Printing.Configuration.PrintSchema.OrientationValues.Portrait; 

double width, height; 

GetPaperWidthHeight(pcJobTicket, queue, out width, out height); 
// Add a page of visual 

pc.AddPage(new DimensionPage(width, height)); 

// Print 
pc.PrintO; 

} 

internal static void GetPaperWidthHeight(Microsoft.PrintingJobTicket.JobTicket jt 

System.Printing.PrintSubSystem.PrintQueue pq, out double width, out double height) { 

Microsoft.Printing.DeviceCapabilities.DeviceCapabilities devcap = 
new Microsoft.Printing.DeviceCapabilities.DeviceCapabilities( 
pq.AcquireDeviceCapabilities(null)); 

devcap.LengthUnitType = System.Pri 

width = (double) devcap.PageCanvasSizeCap.CanvasSizeX * 96; 
height = (double) devcap.PageCanvasSizeCap.CanvasSizeY * 96; 



The next example demonstrates how to print based on the GetPage event The GeneratePaqe method i' 
used to handle the event. 
[C#] 

public static void EventDriven() { 
System.Printing.PrintSubSystem.LocalPrintServer ps = 
new System.Printing.PrintSubSystem.LocalPrintServer(); 

System. Printing. PrintSubSystem.PrintQueue queue = ps.DefaultPrintQueue; 

// Create MSAvalon. Windows. Media. PrintContext if OK button was clicked 
MSAvalon. Windows. Media. PrintContext pc = 
new MSAvalon.Windows.Media.PrintContext(queue, "EventDriven(2 pages)"); 

pc.GetPage += new MSAvalon.Windows.Media.PrintContext.GetPageEventHandler(GetAPage); 
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// Print 
pc.PrintO; 

} 

private static MSAvalon. Windows. Media. Visual GeneratePage(object sender, 
int pageNo, MSAvalon.Windows.Media.GetPageEventArgs ev) { 

if (pageNo == 0) { 
return new VectorPage(); 

} 

else if (pageNo == 1){ 
return new lmagePage(); 

} 

else return null; 

} 



When running the sample and performing this operation, a dialog box with an assertion error message 
may appear. Click the Ignore All button to ignore the assertion and print the pages. 
The final example shows how to print to a file by using the PrintContext object's Output property. 
[C#] 

public static void PrintToFile() { 
System. Printing. PrintSubSystem.LocalPrintServer ps = 
new System.Printing.PrintSubSystem.LocalPrintServerO; 

System. Printing. PrintSubSystem.PrintQueue queue = ps.DefaultPrintQueue; 

// Create PrintContext if OK button was clicked 
MSAvalon.Windows.Media.PrintContext pc = 
new MSAvalon.Windows.Media.PrintContext(queue, "PrintToFile"); 

pc.Output = "testprn"; 

// Add a page of visual 
pc.AddPage(new VectorPage()); 

// Print 
pc.Print(); 

} 



EllipseGeometry Class 

Definition: Represents the geometry of a circle or ellipse. 



Method 



Description 



CloneDownToUnchangeable 

Copy 
Copy 



CloneCore 



CloneCore 



Returns a modifiable shallow or deep clone of the current object. 
This abstract method must be implemented by classes that 
derive from Changeable. Inherited from Changeable. 
Implementation of Animatable.CloneCore. 

Returns an immutable copy of the specified object. Inherited from 
Changeable. 

Creates a copy of this EllipseGeometry. 

Returns a modifiable copy of the current object. The copy's 
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Copy 

DisableCore 
Dispose 



EmbeddedChangeableReader 
EmbeddedChangeableWriter 
EnableCore 

Equals 

Finalize 

GetBounds 

GetCurrentValue 



IsChangeable property is true and its StatusOfNextUse is 
Unchangeable. Inherited from Changeable. 

Creates a copy of this Geometry. Inherited from Geometry. 

Inherited from Geometry. 

Releases the resources associated with the object. Inherited from 
Geometry. 

DoesContain Returns if point is inside the geometry. Inherited from Geometry. 

EllipseGeometry Initializes a new instance of the EllipseGeometry class. 

EmbeddedAnimationCollectionReader Maybe this should be internal?? Inherited from Animatable. 
EmbeddedAnimationCollectionWriter Inherited from Animatable. 

Inherited from Animatable. 
Inherited from Animatable. 
Inherited from Geometry. 

Determines whether two Object instances are equal. Inherited 
from Object. 

Inherited from Geometry. 

Returns the bounds of a Geometry, widened according to the 
characteristics of the specified pen. Inherited from Geometry. 

Returns a non-animated version of this EllipseGeometry that 
represents its current state. 

Returns a non-animated version of this Animatable that 
represents its current state. Inherited from Animatable. 

Returns a non-animated version of this Geometry that represents 
its current state. Inherited from Geometry. 

Serves as a hash function for a particular type, suitable for use in 
hashing algorithms and data structures like a hash 
table. Inherited from Object. 

Gets the Type of the current instance. Inherited from Object. 
Makes an object immutable; after this method is called on a 
Changeable, its IsChangeable property is false. Inherited from 
Changeable. 

Inherited from Geometry. 

Creates a shallow copy of the current Object. Inherited from 
Object. 

Adds or removes a Changed event handler to or from the 
specified Changeable object, if the object is currently modifiable. 
If the specified object is not modifiable— if its IsChangeable 
property is false— this method has no effect. Inherited from 
Changeable. 

Called when the current object is modified. Classes that derive 
from Changed should call this method after they have been 
modified. Inherited from Changeable. 

Implementation of PropagateEventHandler. 
Ensures that simple (non-Changeable) members are being 
accessed from a valid Ul context. This method should be called 
before any simple members are accessed. Inherited from 
Changeable. 

Determines whether the specified Object instances are the same 
instance. Inherited from Object. 



GetCurrentValue 



GetCurrentValue 



GetHashCode 



GetType 

MakeUnchangeable 

MakeUnchangeableCore 
MemberwiseClone 



ModifyHandlerlfChangeable 



OnChanged 

PropagateEventHandler 



ReadPreamble 



ReferenceEquals 
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SetDefaultParentTimeline 

SetDefaultParentTimelineCore 
ToString 

ValidateObjectState 
WritePostscript 

WritePreamble 



This will change the time parent for animations on any of the 
properties of this Changeable which are inheriting their time 
parent. Inherited from Animatable. 

Inherited from Geometry. 

Returns a String that represents the current Object Inherited 
from Object. 

Verifies that the current object has a valid state. If the object is in 
an invalid state, this method throws an exception. Inherited from 
Changeable. 

Causes the current object to validate itself and then invokes the 
OnChanged method. Inherited from Changeable. 
Ensures that simple (non-Changeable) members are being 
accessed from a valid user interface (Ul) context. This method 
should be called before any simple members are set. Inherited 
from Changeable. 



Property Description 

Used in conjunction with the ChangeableUsageOverride type sent in 

AllowChangeableReferenceOverride ! s a P arameter t0 ChangeableHelper.UseChangeable, to help 

determine when a Changeable being put into "use" should be 
promoted to "ChangeableReference". Inherited from Changeable. 

Bounds Gets a Rect that represents the bounding box of a EllipseGeometry. 

This method does not take any pens into account. 

True if this Changeable can be made unchangeable. Inherited from 
Changeable. 

Gets or sets the center point of the ellipse. 

Gets or sets a collection of PointModifier objects that animate the 
center position of the ellipse. 

The current parent Timeline associated with this Animatable. This 
will be the Timeline set to the ParentTimeline property of this 
Animatable if one has been set and if not, the Timeline last passed 
into the SetDefaultParentTimeline method. Inherited from 
Animatable. 



CanMakeUnchangeable 
Center 

CenterAnimations 
DefaultParentTimeline 



HasAnimations 

IsAnimating 

IsChangeable 

I sOverrid ing BaseVal ue 
RadiusX 

RadiusXAnimations 
RadiusY 

RadiusYAnimations 
StatusOfNextUse 



Gets a Boolean that indicates whether the geometry has 
animations. 

Returns true if the geometry contains active animations. 
Gets a Boolean that indicates whether the object is currently 
modifiable. Inherited from Changeable. 

Gets or sets the x-radius value of the ellipse. 

Gets or sets a collection of DoubleModifier objects that animate the 
x-radius of the ellipse. 

Gets or sets the y-radius value of the ellipse. 

Gets or sets a collection of DoubleModifier objects that animate the 
y-radius of the ellipse. 

Gets or sets a UseStatus enumeration that specifies how the 
Changeable object behaves when it is "used." A Changeable object 
is considered used in the following situations: the object is set into a 
Property System property, the object is used as a sub-object in a 
complex Changeable object, or the object is used in a 
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brawinguonrext commana mnentea rrom unangeaoie. 

Gets or sets the Transform object applied to a Geometry. Inherited 
from Geometry. 

Gets the UlContext of the current object The UlContext is used for 
maintaining thread safety. Inherited from Changeable. 

This example demonstrates how to draw shapes using the Geometry, Patnhigure, and Patn^egment 
classes. In this example, several shapes are drawn using Geometry objects ana are displayed using a 
Path element. 

There is a Geometry class for each basic geometric shape: LineGeometry, EllipseGeometry, and 
RectangleGeometry. Complex shapes, such as polygons and shapes with curved segments! may be 
created using a PathGeometry. 

In the following example, a LineGeometry, EllipseGeometry, and a RectangleGeometry object are used to 
create a line, an ellipse, and a rectangle. 

// C# 

MSAvalon. Windows. Media. LineGeometry myLineGeometry = 
new LineGeometry(new Point(50, 50), new Point(300, 50)); 

MSAvalon. Windows. Media. EllipseGeometry myEUipseGeometry = 
new EllipseGeometry(new Point(440, 100), 40, 75); 

MSAvalon. Windows.Media. RectangleGeometry myRectangleGeometry = 
new RectangleGeometry(new Rect(new Point(400, 225), new Size(100, 50))); 

•VB.NET 

Dim myLineGeometry As new MSAvalon.Windows.Media.LineGeometry( _ 

new MSAvalon. Windows. Point(50, 50), new MSAvalon. Windows. Point(300, 50)) 
Dim myEUipseGeometry As new MSAvalon. Windows.Media. EllipseGeometry( _ 

new MSA valon. Windows. Point(440, 100), 40, 75) 
Dim myRectangleGeometry As new MSAvalon. Windows.Media. RectangleGeometry( _ 

new MSA valon. Windows. Rect(new MSAvalon. Windows. Point(400,225), _ 

new MSAvalon. Windows. Size(1 00,50))) 



PathGeometry objects can be used to create complex shapes, such as arcs and curves. PathGeometry 
objects are comprised of one or more PathFigure objects; each PathFigure represents a different "figure" 
or shape. Each PathFigure is itself comprised of one or more PathSegment objects, each representing a 
connected portion of the figure or shape. Segment types include the following: LineSegment, 
BezierSegment, and ArcSegment. 

In the following code, a PathGeometry and a PathFigure are created, and several segments are added to 
the PathFigure to form a shape. There are several ways to add segments to a PathFigure; you can use 
the PathFigure object's "draw segment" commands to automatically create new segments and add them 
to the figure, or you can explicitly create segments and add them manually using the PathFigure object's 
Segments property or AddSegment method. This example shows both ways of adding segments to a 
figure. 

The first segment of a PathFigure must be a StartSegment. The StartSegment may be added by creating 
a new StartSegment and adding it to the PathFigure, or it can be added using the PathFigure object's 
StartAt method. The following code demonstrates adding a StartSegment using the StartAt method. The 
start point is set to (200,50). 

II C# 
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MSAvalon. Windows.Media. PathGeometry myPathGeometry = new PathGeometry(); 
MSAvalon.Windows.Media. PathFigure myPathFigure = new PathFigure(); 

// PathFigure objects must have a defined start point before 
// other segments can be added. 
myPathFigure.StartAt(new Point(200,50)); 

* VB .NET 

Dim myPathGeometry As new MSAvalon.Windows.Media.PathGeometry() 
Dim myPathFigure As new MSAvalon. Windows. Media. PathFigure() 

' PathFigure objects must have a defined start point before 
* other segments can be added. 

myPathFigure.StartAt(new MSAvaton.Windows.Point(200,50)) 

In the following code, the BezierTo method is used to create three B6zier curves. A fourth curve is 
created by explicitly creating a BezierSegment and adding it to myPathFigure using the AddSegment 
method. After the segments are added to the PathFigure (myPathFigure), the PathFigure is added to the 
PathGeometry. 

//C# 

myPathFigure.BezierTo( 

new Point(400, 100), new Point(400, 200), new Point(200, 300)); 

myPathFigure. BezierTo( 
new Point(400, 300), new Point(400, 100), new Point(200, 50)); 

myPathFigure.BezierTo( 
new Point(0, 100), new Point(0, 200), new Point(200,300)); 

MSAvalon.Windows.Media.BezierSegment my BezierSegment = 
new BezierSegment(new Point(0, 300), new Point(0, 100), new Point(200, 50), true); 

myPathFigure.AddSegment(myBezierSegment); 

myPathGeometry.Figures.Add(myPathFigure); 

•VB.NET 

myPathFigure. BezierTo(new MSAvalon. Windows. Point(400, 100), _ 
new MSAvalon. Windows. Point(400, 200), new MSAvalon. Windows. Point(200, 300)) 

myPathFigure. BezierTo(new MSAvalon. Windows. Point(400, 300), _ 
new MSAvalon.Windows.Point(400, 100), new MSAvalon. Windows. Point(200, 50)) 

myPathFigure. BezierTo(new MSAvalon.Windows.Point(0, 100), _ 
new MSAvalon. Windows. Point(0, 200), new MSAvalon.Windows.Point(200,300)) 

Dim myBezierSegment As new BezierSegment( _ 
new MSAvalon. Windows. Point(0, 300), new MSAvalon. Windows. Point(0, 100), _ 
new MSA valon. Windows. Point(200, 50), true) 

myPathFigure.AddSegment(myBezierSegment) 

' Add the PathFigure to the PathGeometry 
myPathGeometry.Figures.Add(myPathFigure) 



76 



In the final code example, the geometries are added to a GeometryCollection, and the 
GeometryCollection is used to set the Path element's Data property. Had there been only one geometry, 
it could have been used to set the Data property directly, without the GeometryCollection. 

//C# 

GeometryCollection myGeometryCollection = new GeometryCollectionQ; 
myGeometryCollection.Add(myLineGeometry); 
myGeometryCollection. Add(myEllipseGeometry); 
myGeometryCollection.Add(myRectangleGeometry); 
myGeometryCollection.Add(myPathGeometry); 

Path myPath = new Path(); 
myPath.Data = myGeometryCollection; 

// Set the outline and the fill of the Path element. 

myPath.Stroke = Brushes.Blue; 

myPath.StrokeThickness = new Length(5); 

SolidColorBrush solidFill = new SolidColorBrush(); 

myPath.Fill = new RadialGradientBrush(Colors.Orange, Colors.Red); 

// Add the Path element to a Canvas. 
myCanvas.Children.Add(myPath); 

1 VB .NET 

Dim myGeometryCollection As new MSAvalon.Windows.Media.GeometryCollection() 

myGeometryCollection.Add(myLineGeometry) 

myGeometryCollection.Add(myEllipseGeometry) 

myGeometryCollection.Add(myRectangleGeometry) 

myGeometryCollection.Add(myPathGeometry) 

Dim myPath As new Path() 
myPath.Data = myGeometryCollection 

' Set the outline and the fill of the Path element. 
myPath.Stroke = MSAvalon.Windows.Media.Brushes.Blue 
myPath.StrokeThickness = new MSAvalon. Windows. Length(5) 
Dim solidFill As new MSAvalon.Windows.Media.SolidColorBrush() 
myPath.Fill = new RadialGradientBrush(MSAvalon.Windows.Media.Colors.Orange, _ 
MSAvalon.Windows.Media.Colors.Red) 

1 Add the Path element to a Canvas. 
myCanvas.Children.Add(myPath) 

Geometry objects may also be rendered using the DrawingContext, which supplies a DrawGeometry 
method that may be used to render Geometry objects. Geometry objects may also be used for clipping 
and hit-testing. 

This example demonstrates how to draw shapes using the Geometry and Path elements in "Longhorn" 
markup language (code-named "XAML"). 

In the following example, a Path is drawn on a Canvas. Several Geometry elements are assigned to the 
Path element's Data attribute. 
<Canvas ID="root" 
Background="White" 

xmlns="http://schemas.microsoft.com/2003/xamr> 
<Path ID="myPath M 
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Fills-Blue" 

Stroke="Black" 

StrokeThickness="5"> 



<Path.Data> 
<GeometryCollection> 

<LineGeometry StartPoint="50,50" EndPoint="300,507> 
<EllipseGeometry Center="440, 100" RadiusX="40" RadiusY="757> 

<RectangleGeometry > 
<Rectang!eGeometry.Rect> 

<Rect X="400 n Y="225" Width="100" Height="507> 
</RectangleGeometry. Rect> 
</RectangleGeometry> 

<PathGeometry> 
<PathGeometry.Figures> 
<PathFigureCollection> 
<PathFigure> 
<PathFigure.Segments> 
<PathSegmentCollection> 
<StartSegment Point="400,1007> 

<BezierSegment Point1="400,100" Point2="400,200" Point3="200,3007> 
<BezierSegment Pointl ="400,300" Point2="400,100" Point3="2Q0,507> 
<BezierSegment Pointl ="0,1 00" Point2="0,200" Point3="200,300"/> 
<BezierSegment Pointl ="0,300" Point2="0,100" Point3="200,507> 
</PathSegmentCollection> 
</PathFigure.Segments> 
</PathFigure> 
</PathFigureCollection> 
</PathGeometry.Figures> 
</PathGeometry> 

</GeometryCollection> 

</Path.Data> 
</Path> 



</Canvas> 

In the previous example, the PathFigure object, one of the shapes drawn inside the Path element, 
contains a StartSegment but no CloseSegment; if a CloseSegment were added to the figure, a line would 
be drawn from the last segment in the collection back to the starting point of the figure. 

This example demonstrates how to animate a Geometry. In the following example, a PointAnimation is 
used to animate the Center of an EllipseGeometry. 

<Canvas ID="root" 

xmlns="http://schemas.microsoft.com/2003/xaml"> 

<!- Use a Path to draw the Geometry. -> 

<Path ID="myPath" 
Fill="Blue u 
Stroke="Black" 
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StrokeThickness="5"> 

<Path.Data> 

<!-- Draw an Ellipse. -> 

<EllipseGeometry Center="100,100" RadiusX="25" RadiusY="100"> 

<EllipseGeometry.CenterAnimations> 
<!-Animate the center of this ellipse: --> 
<PointAn imation From="100,100" To="50,50" 
Duration="5" Begin="O u AutoReverse="true M RepeatCount="207> 
</EllipseGeometry.CenterAnimations> 

</EllipseGeometry> 
</Path.Data> 
</Path> 
</Canvas> 

In the previous example, the PointAnimationCollection tag, <PointAnimationCollection> is omitted when 
animating the ellipse's center. When animating a designated animation property— properties of the form 
PropertyNameAnimations, such as the CenterAnimations property in the previous example — you may 
omit the animation collection tag. However, when animating a property of a Ul element— those classes 
that derive from UlElement— you must nest the animations within an animation collection tag. For more 
information about animating properties, see Animation in "Avalon". 

//C# 

EllipseGeometry myEllipseGeometry = new EllipseGeometry(); 
myEllipseGeometry.Center = new Point(200,200); 
myEllipseGeometry. RadiusX = 25; 
myEllipseGeometry.RadiusY = 50; 

PointAnimation myPointAnimation = new PointAnimation(); 
myPointAnimation.From = new Point(200,200); 
myPointAnimation. To = new Point(50,50); 
myPointAnimation. Duration = new Time(5000); 
myPointAnimation. Begin = new TimeSyncValue(new Time(0)); 
myPointAnimation.AutoReverse = true; 
myPointAnimation. RepeatCount = 20; 

myEllipseGeometry.CenterAnimations.Add(myPointAnimation); 



'VB.NET 

Dim myEllipseGeometry As new MSAvalon.Windows.Media.EllipseGeometry 
myEllipseGeometry.Center = new MSAvalon. Windows. Point(200,200) 
myEllipseGeometry. RadiusX = 25 
myEllipseGeometry.RadiusY = 50 

Dim myPointAnimation As new MSAvalon. Windows. Media. Animation. PointAnimation 
myPointAnimation.From = new MSAvalon. Windows. Point(200,200) 
myPointAnimation.To = new MSAvalon.Windows.Point(50,50) 
myPointAnimation. Duration = new Time(5000) 
myPointAnimation. Begin = new TimeSyncValue(new Time(0)) 
myPointAnimation.AutoReverse = true 
myPointAnimation. RepeatCount = 20 

myEllipseGeometry.CenterAnimations.Add(myPointAnimation) 
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F ntFamily Class 

Definition: Font Family. 



Method 

Equals 

Finalize 
FontFamily 
GetHashCode 
GetType 

MemberwiseClone 
ReferenceEquals 

ToString 



Description 

Determines whether two Object instances are equal. Inherited from Object. 
Allows an Object to attempt to free resources and perform other cleanup operations 
before the Object is reclaimed by garbage collection. Inherited from Object. 
Construct a font family 

Serves as a hash function for a particular type, suitable for use in hashing algorithms 
and data structures like a hash table. Inherited from Object. 

Gets the Type of the current instance. Inherited from Object. 

Creates a shallow copy of the current Object. Inherited from Object. 

Determines whether the specified Object instances are the same instance. Inherited 
from Object. 

Returns a String that represents the current Object. Inherited from Object. 



Property Description 

Baseline Distance from character cell top to English baseline relative to em size. 

FamilyName Font family name 

Height Full height of character cell relative to em size 



FormattedText Class 

Definition: The FormattedText class is a part of Avalon MIL easy text API, which is targeted at 
programmers needing to add some simple text to a MIL visual. 



Method 

BuildGeometry 

BuildHighlightGeometry 

Equals 

Finalize 

FormattedText 
GetHashCode 

GetMaxTextWidths 
GetType 

MemberwiseClone 

ReferenceEquals 

SetFontFamily 
SetFontSize 



Description 

Obtains geometry for the text, including underlines and strikethroughs. 
Builds a highlight geometry object. 

Determines whether two Object instances are equal. Inherited from Object. 
Allows an Object to attempt to free resources and perform other cleanup 
operations before the Object is reclaimed by garbage collection. Inherited from 
Object. 

Construct a FormattedText object 

Serves as a hash function for a particular type, suitable for use in hashing 
algorithms and data structures like a hash table. Inherited from Object. 
Obtains a copy of the array of lengths, which will be applied to each line of text 
in turn. If the text covers more lines than there are entries in the length array, 
the last entry is reused as many times as required. The maxTextWidths array 
overrides the MaxTextWidth property. 

Gets the Type of the current instance. Inherited from Object. 

Creates a shallow copy of the current Object. Inherited from Object. 

Determines whether the specified Object instances are the same 
instance. Inherited from Object. 

Sets or changes the font family for the text object 

Sets or changes the font em size measured in MIL units 
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SetFontStretch 

SetFontStyle 

SetFontTypeface 

SetFontWeight 

SetForegroundBrush 

SetMaxTextWidths 

SetTextDecorations 
ToString 



Sets or changes the font stretch 

Sets or changes the font style 

Sets or changes the type face 

Sets or changes the font weight 

Sets foreground brush used for drawing text 

Sets the array of lengths, which will be applied to each line of text in turn. If the 
text covers more lines than there are entries in the length array, the last entry is 
reused as many times as required. The maxTextWidths array overrides the 
MaxTextWidth property. 

Sets or changes the text decorations 

Returns a String that represents the current Object. Inherited from Object. 



Property 



Baseline 

Extent 

Height 

LineHeight 
MaxLineCount 

MaxTextHeight 



MaxTextWidth 



MinWidth 

OverhangAfter 

OverhangLeading 

OverhangTrailing 
Text 

Trimming 
Width 



Description 

The distance from the top of the first line to the baseline of the first line. 

The distance from the topmost black pixel of the first line to the 
bottommost black pixel of the last line. 

The distance from the top of the first line to the bottom of the last line. 
Defines the height of each line, and thus the spacing between lines. 
Default value: Line height defaults to the recommended line spacing of 
the font passed to the FormattedText constructor. 
Defines the maximum number of lines to display. The last line of text 
displayed is the lineCount-rth line, or the last whole line that will fit 
within the count set by MaxTextHeight, whichever occurs first. Use the 
Trimming property to control how the omission of text is indicated 
Sets the maximum length of a column of text. The last line of text 
displayed is the last whole line that will fit within this limit, or the nth 
line as specified by MaxLineCount, whichever occurs first. Use the 
Trimming property to control how the omission of text is indicated. 
Defines the maximum length of lines. Text will be word-wrapped if 
necessary to avoid exceeding this limit. Note that it is glyph alignment 
edges that are kept within the line count limit. Many fonts contain 
glyphs that overhang a little beyond their alignment edges. Clients 
should allow at least 1/6 em (font size) margin beyond the line count 
requested to leave room for such overhangs. A zero value for line 
count is treated as an infinite line count. 

The minimum line count that can be specified without causing any 
word to break. 

The distance from the bottom of the last line to the extent bottom. 

The maximum distance from the leading black pixel to the leading 
alignment point of a line. 

The maximum distance from the trailing black pixel to the trailing 
alignment point of a line. 

Returns the string of text to be displayed 

Defines how omission of text is indicated. CharacterEllipsis trimming 
allows partial words to be displayed, while WordEllipsis removes whole 
words to fit. Both guarantee to include an ellipsis (*...') at the end of the 
lines where text has been trimmed as a result of line and column limits. 
The maximum advance width between the leading and trailing 
alignment points of a line, excluding the width of whitespace 
characters at the end of the line. 
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The maximum advance width between the leading and trailing 
WidthlncludingTrailingWhitespace alignment points of a line, including the width of whitespace characters 

at the end of the line. 

The following example shows the simplest way to draw text to a visual in C#. The DrawText method is 
used to pass FormattedText to the DrawingContext object. The DrawingContext is later drawn to the 
screen using the RenderOpen method of the DrawingVisual object. 

[C#] 

using System; 

using MSAvalon.Windows; 

using MSAvalon.Windows. Controls; 

using MSAvalon.Windows.Media; 

namespace DrawText_Demo 
{ 

public class MyApp : MSAvalon.Windows.Application 

MSAvalon.Windows. Media. DrawingContext myDrawingContext; 
MSAvalon.Windows.Media.DrawingVisual myDrawingVisual; 
MSAvalon.Windows. Window mainWindow; 

protected override void OnStartingUp (StartingUpCancelEventArgs e) 

base.OnStartingUp (e); 
CreateAndShowMainWindow (); 



private void CreateAndShowMainWindow () 
{ 

// Create the application's main window 
mainWindow = new MSAvalon.Windows.Window (); 
mainWindow. Show (); 

// Draw the Text 
DrawingVisual myDrawingVisual = new DrawingVisual(); 
DrawingContext myDrawingContext = myDrawingVisual. RenderOpen(); 

^ m myDrawingContext-DrawTextCnewFormattedTextCHello World'" new 

TypefacefVerdana"), 14, Brushes. Black), newPoint(10, 10)); 

myDrawingContext.Close(); 

((IVisual)mainWindow).Children.Add(myDrawingVisual); 
} } 

internal sealed class EntryClass 
{ 

[System.STAThreadO] 
private static void Main () 
{ 

MyApp app = new MyApp (); 
app.Run (); 

} 

} 
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} 



Geometry Class 

Definition: An abstract class that provides base functionality for all geometry classes, such as 
EllipseGeometry, RectangleGeometry, and PathGeometry. The Geometry class of objects can be used 
for clipping, hit-testing, and rendering 2-D graphic data. 



Method 



CloneCore 



CloneCore 

CloneDownToUnchangeable 

Copy 
Copy 

DisableCore 
Dispose 
DoesContain 

EmbeddedAnimationCollectionReader 
EmbeddedAnimationCollectionWriter 
EmbeddedChangeableReader 
EmbeddedChangeableWriter 
EnableCore 

Equals 

Finalize 

GetBounds 

GetCurrentValue 

GetCurrentValue 

GetHashCode 
GetType 

MakeUnchangeable 

MakeUnchangeableCore 
MemberwiseClone 

ModifyHandlerlfChangeable 



Description 

Returns a modifiable shallow or deep clone of the current object. 
This abstract method must be implemented by classes that 
derive from Changeable. Inherited from Changeable. 
Subclasses must implement this to provide clones of 
themselves. Inherited from Animatable. 

Returns an immutable copy of the specified object. Inherited 
from Changeable. 

Returns a modifiable copy of the current object. The copy's 
IsChangeable property is true and its StatusOfNextUse is 
Unchangeable. Inherited from Changeable. 
Creates a copy of this Geometry. 

Releases the resources associated with the object. 
Returns if point is inside the geometry. 
Maybe this should be internal?? Inherited from Animatable. 
Inherited from Animatable. 
Inherited from Animatable. 
Inherited from Animatable. 

Determines whether two Object instances are equal. Inherited 
from Object. 

Returns the bounds of a Geometry, widened according to the 
characteristics of the specified pen. 
Returns a non-animated version of this Animatable that 
represents its current state. Inherited from Animatable. 

Returns a non-animated version of this Geometry that represents 
its current state. 

Serves as a hash function for a particular type, suitable for use in 
hashing algorithms and data structures like a hash 
table. Inherited from Object. 

Gets the Type of the current instance. Inherited from Object. 
Makes an object immutable; after this method is called on a 
Changeable, its IsChangeable property is false. Inherited from 
Changeable. 

Creates a shallow copy of the current Object. Inherited from 
Object. 

Adds or removes a Changed event handler to or from the 
specified Changeable object, if the object is currently modifiable. 
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OnChanged 
PropagateEventHandler 

ReadPreamble 

ReferenceEquals 

SetDefaultParentTimeline 

SetDefaultParentTimelineCore 
ToString 

ValidateObjectState 
WritePostscript 

WritePreamble 



If the specified object is not modifiable— if its IsChangeable 
property is false— this method has no effect Inherited from 
Changeable. 

Called when the current object is modified. Classes that derive 
from Changed should call this method after they have been 
modified. Inherited from Changeable. 

Ensures that simple (non-Changeable) members are being 
accessed from a valid Ul context. This method should be called 
before any simple members are accessed. Inherited from 
Changeable. 

Determines whether the specified Object instances are the same 
instance. Inherited from Object. 

This will change the time parent for animations on any of the 
properties of this Changeable which are inheriting their time 
parent. Inherited from Animatable. 

Returns a String that represents the current Object. Inherited 
from Object. 

Verifies that the current object has a valid state. If the object is in 
an invalid state, this method throws an exception. Inherited from 
Changeable. 

Causes the current object to validate itself and then invokes the 
OnChanged method. Inherited from Changeable. 
Ensures that simple (non-Changeable) members are being 
accessed from a valid user interface (Ul) context. This method 
should be called before any simple members are set. Inherited 
from Changeable. 



Property Description 

Used in conjunction with the ChangeableUsageOverride type sent in 

AllowChangeableReferenceOverride * s a P arameter to ChangeableHelper.UseChangeable, to help 

determine when a Changeable being put into "use" should be 
promoted to "ChangeableReference". Inherited from Changeable. 

Bounds Gets a Rect that specifies the bounding box of a Geometry. This 

method does not take any pens into account. 

True if this Changeable can be made unchangeable. Inherited from 
Changeable. 

The current parent Timeline associated with this Animatable. This 
will be the Timeline set to the ParentTimeline property of this 
Animatable if one has been set and if not, the Timeline last passed 
into the SetDefaultParentTimeline method. Inherited from 
Animatable. 



CanMakeUnchangeable 



DefaultParentTimeline 



HasAnimations 

IsAnimating 

IsChangeable 

IsOverridingBaseValue 
StatusOfNextUse 



Gets a Boolean that indicates whether the geometry has 
animations. 

Returns true if the geometry contains animations that are active. 
Gets a Boolean that indicates whether the object is currently 
modifiable. Inherited from Changeable. 

Gets or sets a UseStatus enumeration that specifies how the 
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Changeable object behaves when it is "used." A Changeable object 
is considered used in the following situations: the object is set into a 
Property System property, the object is used as a sub-object in a 
complex Changeable object, or the object is used in a 
DrawingContext command. Inherited from Changeable. 
Transform Gets or sets the Transform object applied to a Geometry. 

UlContext Gets the UICont ext of the current object. The UlContext is used for 

maintaining thread safety. Inherited from Changeable. 

This example demonstrates how to draw shapes using the Geometry, PathFigure, and PathSegment 
classes. In this example, several shapes are drawn using Geometry objects and are displayed usinq a 
Path element. 

There is a Geometry class for each basic geometric shape: LineGeometry, EllipseGeometry, and 
RectangleGeometry. Complex shapes, such as polygons and shapes with curved segments! may be 
created using a PathGeometry. 

In the following example, a LineGeometry, EllipseGeometry, and a RectangleGeometry object are used to 
create a line, an ellipse, and a rectangle. 

//C# 

MSAvalon.Windows.Media.LineGeometry myLineGeometry = 
new LineGeometry(new Point(50, 50), new Point(300, 50)); 

MSAvalon.Windows.Media.EllipseGeometry myEllipseGeometry = 
new EllipseGeometry(new Point(440, 100), 40, 75); 

MSAvalon. Windows. Media. RectangleGeometry my RectangleGeometry = 
new RectangleGeometry(new Rect(new Point(400, 225), new Size(100, 50))); 

1 VB NET 

Dim myLineGeometry As new MSAvalon. Windows.Media.LineGeometry( _ 
new MSAvalon.Windows.Point(50, 50), new MSAvalon. Windows. Point(300, 50)) 

Dim myEllipseGeometry As new MSAvalon. Windows.Media.EllipseGeometry( _ 
new MSAvalon. Windows. Point(440, 100), 40, 75) 

Dim myRectangleGeometry As new MSAvalon.Windows.Media.RectangleGeometry( _ 
new MSA valon. Windows. Rect(new MSAvalon. Windows. Point(400, 225), _ 
new MSAvalon.Windows.Size(1 00,50))) 



PathGeometry objects can be used to create complex shapes, such as arcs and curves. PathGeometry 
objects are comprised of one or more PathFigure objects; each PathFigure represents a different "figure" 
or shape. Each PathFigure is itself comprised of one or more PathSegment objects, each representing a 
connected portion of the figure or shape. Segment types include the following: LineSegment, 
BezierSegment, and ArcSegment. 

In the following code, a PathGeometry and a PathFigure are created, and several segments are added to 
the PathFigure to form a shape. There are several ways to add segments to a PathFigure; you can use 
the PathFigure object's "draw segment" commands to automatically create new segments and add them 
to the figure, or you can explicitly create segments and add them manually using the PathFigure object's 
Segments property or AddSegment method. This example shows both ways of adding segments to a 
figure. 

The first segment of a PathFigure must be a StartSegment. The StartSegment may be added by creating 
a new StartSegment and adding it to the PathFigure, or it can be added using the PathFigure object's 
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StartAt method. The following code demonstrates adding a StartSegment using the StartAt method. The 
start point is set to (200,50). 

//C# 

MSAvalon. Windows. Media. PathGeometry myPathGeometry = new PathGeometry(); 
MSAvalon.Windows.Media.PathFigure myPathFigure = new PathFigure(); 

// PathFigure objects must have a defined start point before 
// other segments can be added. 
myPathFigure.StartAt(new Point(200,50)); 

'VB.NET 

Dim myPathGeometry As new MSAvalon.Windows.Media.PathGeometry() 
Dim myPathFigure As new MSAvalon.Windows.Media.PathFigureQ 

1 PathFigure objects must have a defined start point before 
' other segments can be added. 

myPathFigure.StartAt(newMSAvalon.Windows.Point(200,50)) 

In the following code, the BezierTo method is used to create three B6zier curves. A fourth curve is 
created by explicitly creating a BezierSegment and adding it to myPathFigure using the AddSegment 
method. After the segments are added to the PathFigure (myPathFigure), the PathFigure is added to the 
PathGeometry. 

II C# 

myPathFigure.BezierTo( 
new Point(400, 100), new Point(400, 200), new Point(200, 300)); 

myPathFigure. BezierTo( 
new Point(400, 300), new Point(400, 100), new Point(200, 50)); 

myPathFigure. BezierTo( 
new Point(0, 100), new Point(0, 200), new Point(200,300)); 

MSAvalon.Windows.Media.BezierSegment myBezierSegment = 
new BezierSegment(new Point(0, 300), new Point(0, 100), new Point(200, 50), true); 

myPathFigure.AddSegment(myBezierSegment); 

myPathGeometry.Figures.Add(myPathFigure); 

* VB .NET 

myPathFigure. BezierTo(new MSAvalon. Windows. Point(400, 100), _ 
new MSAvalon. Windows. Point(400, 200), new MSAvalon.Windows.Point(200, 300)) 

myPathFigure.BezierTo(new MSAvalon.Windows.Point(400, 300), _ 
new MSAvalon. Windows. Point(400, 100), new MSAvalon. Windows. Point(200, 50)) 

myPathFigure.BezierTo(new MSAvalon. Windows. Point(0, 100), _ 
new MSAvalon. Windows. Point(0, 200), new MSAvalon.Windows.Point(200,300)) 

Dim myBezierSegment As new BezierSegment( _ 

new MSAvalon. Windows. Point(0, 300), new MSAvalon. Windows. Point(0, 100), _ 
new MSAvalon. Windows. Point(200, 50), true) 

myPathFigure.AddSegment(myBezierSegment) 
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}h e Pali {Figure to the FaihGeorneirv 
myKainueometry>igures.Add(myPathFigure) 

In the final code example, the geometries are added to a GeometrvCollection. and the 

Geo me to/Go! lection is used to set the Path element's Data property. Had there been only one geometry 

it could have been used to set the Data property directly, without the GeometryCollection. 

// C# 

GeometryCollection myGeometryCollection = new GeometryCoiieciion(); 
myGeometryCollection. Add(myLineGeometry); 
myGeometryCollection.Add(myEllipseGeometry); 
myGeometryCollection.Add(myRectangleGeometry); 
myGeometryCollection.Add(myPathGeometry); 

Path myPath = new Path(); 
myPath.Data = myGeometryCollection; 

// Set the outline and the fill of the Path element 

myPath. Stroke = Brushes.Blue; 

myPath.StrokeThickness = new Length(5); 

SolidColorBrush solidFill = new SofidCoIorBrushQ; 

myPath.Fill = new RadialGradientBrush(Colors.Orange, Colors.Red); 

// Add the Path element to a Canvas. 
myCanvas.Children.Add(myPath); 

'VB.NET 

Dim myGeometryCollection As new MSAva{on.Windows.Media.GeometryCollection() 
myGeometryCollection. Add(myLineGeometry) 

myGeometryCollection. Add(myRectangleGeometry) 
mvGeometrvCollection.AddfmvPathGeometrv} 

Dim myPath As new PathQ 

myPath.Data = my Geometry Collection 

' Set the outline and the fill of the Path element. 

.n_xi_ — i . _ a a . . _ i i a f._ j a a _ _j : _^ n „ _ i i-\ i 

myrciui.ouui\c - iviOAAVdiuii.vvmuuwa.ivicuics.Di uSiieS.Diuc 

myPath.StrokeThickness = new MSAvalon. Windows. Length(5) 
Dim solidFi!! As new MSAva!on.Windows.Medi3.So!idCo!orBrush() 
myPath.Fill = new RadialGradientBrush(MSAvalon. Windows. Media.Colors. Orange, _ 
MSAvalon.Windows.MediaColnrs.Rftd) 

1 Add the Path element to a Canvas. 
myCanvas.Children.Add(myPath) 

Geometry objects may also be rendered using the DrawingContext, which supplies a DrawGeometry 
method that may be used to render Geometry objects. Geometry objects may also be used for clipping 
and hit-testing. 

This example demonstrates how to draw shapes using the Geometry and Path elements in "Longhorn" 
markup language (code-named "XAML"). 

In the following example, a Path is drawn on a Canvas. Several Geometry elements are assigned to the 
Path element's Data attribute. 
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<Canvas ID="root" 
Background="White" 

xmlns="http://schemas.microsoft.com/2003/xamr , > 



<Path ID="myPath" 
Fill="Blue H 
Stroke="Black" 
StrokeThickness="5"> 

<Path.Data> 
<GeometryCollection> 

<LineGeometry StartPoint="50,50" EndPoint="300,507> 
<EllipseGeometry Center="440, 100" RadiusX="40" RadiusY= , 75 , 7> 

<RectangleGeometry > 
<RectangleGeometry.Rect> 
<Rect X="400" Y="225" Width="100" Height="507> 
</RectangleGeometry . Rect> 
</RectangleGeometry> 

<PathGeometry> 
<PathGeometry.Figures> 
<PathFigureCollection> 
<PathFigure> 
<PathFigure.Segments> 
<PathSegmentCollection> 
<StartSegment Point="400,1007> 

<BezierSegment Point1="400,100" Point2="400,200" Point3="200,3007> 
<BezierSegment Pointl ="400,300" Point2= M 400,100" Point3="200 t 507> 
<BezierSegment Point1="0,100" Point2="0,200" Point3="200,3007> 
<BezierSegment Pointl ="0,300" Point2="0 f 100" Point3="200,507> 
</PathSegmentCollection> 
</Path Fig u re. Seg ments> 
</PathFigure> 
</PathFigureCollection> 
</PathGeometry.Figures> 
</PathGeometry> 



</GeometryCollection> 

</Path.Data> 
</Path> 



</Canvas> 

In the previous example, the PathFigure object, one of the shapes drawn inside the Path element, 
contains a StartSegment but no CloseSegment; if a CloseSegment were added to the figure, a line would 
be drawn from the last segment in the collection back to the starting point of the figure. 

This example demonstrates how to animate a Geometry. In the following example, a PointAnimation is 
used to animate the Center of an EllipseGeometry. 

<Canvas ID="root" 
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xmlns="http://schemas.microsoft.com/2003/xaml"> 

<!- Use a Path to draw the Geometry. -> 

<Path ID="myPath n 
Fill="Blue" 
Stroke="Black M 
StrokeThickness="5 M > 
<Path.Data> 
<!- Draw an Ellipse. -> 
<EllipseGeometry Center="100,100" RadiusX="25" RadiusY="100"> 

<EllipseGeometry.CenterAnimations> 
<!-Animate the center of this ellipse: --> 
<PointAnimation From="100,100 n To="50,50 n 
Duration="5" Begin="0" AutoReverse="true n RepeatCount="207> 
</EllipseGeometry.CenterAnimations> 

</EllipseGeometry> 
</Path.Data> 
</Path> 
</Canvas> 



In the previous example, the PointAnimationCollection tag, <PointAnimationCollection>, is omitted when 
animating the ellipse's center. When animating a designated animation property— properties of the form 
PropertyNameAnimations, such as the CenterAnimations property in the previous example — you may 
omit the animation collection tag. However, when animating a property of a Ul element— those classes 
that derive from UlElement— you must nest the animations within an animation collection tag. For more 
information about animating properties, see Animation in "Avalon". 

//C# 

EllipseGeometry myEllipseGeometry = new EllipseGeometryQ; 
myEllipseGeometry.Center = new Point(200,200); 
myEllipseGeometry. RadiusX = 25; 
myEllipseGeometry. RadiusY = 50; 

PointAnimation myPointAnimation = new PointAnimation(); 
myPointAnimation.From = new Point(200,200); 
myPointAnimation.To = new Point(50,50); 
myPointAnimation. Duration = new Time(5000); 
myPointAnimation.Begin = new TimeSyncValue(new Time(0)); 
myPointAnimation.AutoReverse = true; 
myPointAnimation. RepeatCount = 20; 

myEllipseGeometry.CenterAnimations.Add(myPointAnimation) 
1 VB NET 

Dim myEllipseGeometry As new MSAvalon.Windows.Media.EllipseGeometry 
myEllipseGeometry.Center = new MSAvalon. Windows. Point(200,200) 
myEllipseGeometry. RadiusX = 25 
myEllipseGeometry.RadiusY = 50 

Dim myPointAnimation As new MSAvalon. Windows. Media. Animation. PointAnimation 
myPointAnimation.From = new MS Avalon. Windows. Point(200,200) 
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myPointAnimationTo = new MSAvalon. Windows. Point(50,50) 
myPointAnimation. Duration = new Time(SOOO) 
myPointAnimation. Begin = new TimeSyncValue(new Time(O)) 
myPointAnimation. AutoReverse = true 
myPointAnimation. RepeatCount = 20 

myEllipseGeometry.CenterAnimations.Add(myPointAnimation) 



GeometryCollection Class 

Definition: Represents a collection of Geometry objects. 



Method 



Add 

AddRange 

Clear 

CloneCore 

CloneCore 



Description 



CloneDownToUnchangeable 

Contains 
Copy 

Copy 

Copy 
CopyTo 
DisableCore 
Dispose 
DoesContain 

EmbeddedAnimationCollectionReader 
EmbeddedAnimationCollectionWriter 
EmbeddedChangeableReader 
EmbeddedChangeableWriter 
EnableCore 

Equals 

Finalize 

GeometryCollection 
GetBounds 

GetCurrentValue 

GetCurrentValue 

GetCurrentValue 



Implementation of Animatable.CloneCore. 
Returns a modifiable shallow or deep clone of the current object. 
This abstract method must be implemented by classes that 
derive from Changeable. Inherited from Changeable. 

Returns an immutable copy of the specified object. Inherited from 
Changeable. 

Creates a copy of this Geometry. Inherited from Geometry. 
Returns a modifiable copy of the current object. The copy's 
JsChangeable property is true and its StatusOfNextUse is 
Unchangeable. Inherited from Changeable. 

Creates a copy of this GeometryCollection. 



Dispose resources associated with geometry. 
Returns if point is inside the geometry. Inherited from Geometry. 
Maybe this should be internal?? Inherited from Animatable. 
Inherited from Animatable. 
Inherited from Animatable. 
Inherited from Animatable. 

Determines whether two Object instances are equal. Inherited 
from Object. 

Inherited from Geometry. 

Returns the bounds of a Geometry, widened according to the 
characteristics of the specified pen. Inherited from Geometry. 

Returns a non-animated version of this GeometryCollection that 
represents its current state. 

Returns a non-animated version of this Geometry that represents 
its current state. Inherited from Geometry. 

Returns a non-animated version of this Animatable that 
represents its current state. Inherited from Animatable. 
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GetEnumerator 

GetHashCode 

GetOptimizedGeometry 

GetRange 

GetType 

lAddChild.AddChild 

lAddChild.AddText 

IList.Add 

IListContains 

IList.lndexOf 

I List. Insert 

I List. Remove 

IndexOf 

Insert 

InsertRange 
LastlndexOf 

MakeUnchangeable 

MakeUnchangeableCore 
MemberwiseClone 



ModifyHandlerlfChangeable 

OnChanged 
PropagateEventHandler 

ReadPreamble 

ReferenceEquals 

Remove 

RemoveAt 

RemoveRange 

SetDefaultParentTimeline 

SetDefaultParentTimelineCore 

SetRange 

ToString 



Serves as a hash function for a particular type, suitable for use in 
hashing algorithms and data structures like a hash 
table. Inherited from Object. 



Gets the Type of the current instance. Inherited from Object. 



Makes an object immutable; after this method is called on a 
Changeable, its IsChangeable property is false. Inherited from 
Changeable. 

Implementation of MakeUnchangeableCore. 

Creates a shallow copy of the current Object. Inherited from 
Object. 

Adds or removes a Changed event handler to or from the 
specified Changeable object, if the object is currently modifiable. 
If the specified object is not modifiable— if its IsChangeable 
property is false— this method has no effect. Inherited from 
Changeable. 

Called when the current object is modified. Classes that derive 
from Changed should call this method after they have been 
modified. Inherited from Changeable. 

Ensures that simple (non-Changeable) members are being 
accessed from a valid Ul context. This method should be called 
before any simple members are accessed. Inherited from 
Changeable. 

Determines whether the specified Object instances are the same 
instance. Inherited from Object. 



This will change the time parent for animations on any of the 
properties of this Changeable which are inheriting their time 
parent. Inherited from Animatable. 



Returns a String that represents the current Object. Inherited 
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ValidateObjectState 
WritePostscript 

WritePreamble 

Property 



from Object. 

Verifies that the current object has a valid state. If the object is in 
an invalid state, this method throws an exception. Inherited from 
Changeable. 

Causes the current object to validate itself and then invokes the 
OnChanged method. Inherited from Changeable. 
Ensures that simple (non-Changeable) members are being 
accessed from a valid user interface (Ul) context. This method 
should be called before any simple members are set. Inherited 
from Changeable. 



Description 

Used in conjunction with the ChangeableUsageOverride type sent in 
AllowChangeableReferenceOverride as a P arameter to ChangeableHelper.UseChangeable, to help 

determine when a Changeable being put into "use" should be 
promoted to "ChangeableReference". Inherited from Changeable. 
Gets a Rect that specifies the bounding box of a Geometry. This 
method does not take any pens into account. Inherited from 
Geometry. 

True if this Changeable can be made unchangeable. Inherited from 
Changeable. 



Bounds 



CanMakeUnchangeable 



Capacity 

CombineMode 

Count 



DefaultParentTimeline 

HasAnimations 
IsAnimating 

IsChangeable 

IsFixedSize 

IsOverridingBaseValue 

Item 

StatusOfNextUse 

Transform 
UlContext 



The current parent Timeline associated with this Animatable. This 
will be the Timeline set to the ParentTimeline property of this 
Animatable if one has been set and if not, the Timeline last passed 
into the SetDefaultParentTimeline method. Inherited from 
Animatable. 



Gets a Boolean that indicates whether the object is currently 
modifiable. Inherited from Changeable. 



Gets or sets a UseStatus enumeration that specifies how the 
Changeable object behaves when it is "used." A Changeable object 
is considered used in the following situations: the object is set into a 
Property System property, the object is used as a sub-object in a 
complex Changeable object, or the object is used in a 
DrawingContext command. Inherited from Changeable. 

Gets or sets the Transform object applied to a Geometry. Inherited 
from Geometry. 

Gets the UlContext of the current object. The UlContext is used for 
maintaining thread safety. Inherited from Changeable. 



This example demonstrates how to draw shapes using the Geometry, PathFigure, and PathSegment 
classes. In this example, several shapes are drawn using Geometry objects and are displayed usina a 
Path element. y 
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There is a Geometry class for each basic geometric shape: LineGeometry, EllipseGeometry, and 
RectangleGeometry. Complex shapes, such as polygons and shapes with curved segments may be 
created using a PathGeometry. 

In the following example, a LineGeometry, EllipseGeometry, and a RectangleGeometry object are used to 
create a line, an ellipse, and a rectangle. 

//C# 

MSAvalon. Windows. Media. LineGeometry myLineGeometry = 
new LineGeometry(new Point(50, 50), new Point(300, 50)); 

MSAvalon. Windows.Media. EllipseGeometry myEllipseGeometry = 
new EllipseGeometry(new Point(440, 100), 40, 75); 

MSAvalon.Windows.Media.RectangleGeometry my RectangleGeometry = 
new RectangleGeometry(new Rect(new Point(400, 225), new Size(100, 50))); 

' VB .NET 

Dim myLineGeometry As new MSAvalon.Windows.Media.LineGeometry( _ 

new MSAvalon.Windows.Point(50, 50), new MSAvalon. Windows. Point(300, 50)) 
Dim myEllipseGeometry As new MSAvalon. Windows.Media. EllipseGeometry( 

new MSAvalon. Windows. Point(440, 100), 40, 75) 
Dim myRectangleGeometry As new MSAvalon.Windows.Media.Rectang!eGeometry( _ 

new MSAvalon. Windows. Rect(new MSAvalon. Windows. Point(400,225), _ 

new MSAvalon. Windows.Size(1 00,50))) 

PathGeometry objects can be used to create complex shapes, such as arcs and curves. PathGeometry 
objects are comprised of one or more PathFigure objects; each PathFigure represents a different "figure" 
or shape. Each PathFigure is itself comprised of one or more PathSegment objects, each representing a 
connected portion of the figure or shape. Segment types include the following: LineSegment 
BezierSegment, and ArcSegment. 

In the following code, a PathGeometry and a PathFigure are created, and several segments are added to 
the PathFigure to form a shape. There are several ways to add segments to a PathFigure; you can use 
the PathFigure object's "draw segment" commands to automatically create new segments and add them 
to the figure, or you can explicitly create segments and add them manually using the PathFigure object's 
Segments property or AddSegment method. This example shows both ways of adding segments to a 
figure. 

The first segment of a PathFigure must be a StartSegment. The StartSegment may be added by creating 
a new StartSegment and adding it to the PathFigure, or it can be added using the PathFigure object's 
StartAt method. The following code demonstrates adding a StartSegment using the StartAt method The 
start point is set to (200,50). 

//C# 

MSAvalon.Windows. Media. PathGeometry myPathGeometry = new PathGeometry(); 
MSAvalon.Windows. Media. PathFigure myPathFigure = new PathFigure(); 

// PathFigure objects must have a defined start point before 
// other segments can be added. 
myPathFigure.StartAt(new Point(200,50)); 

'VB.NET 

Dim myPathGeometry As new MSAvalon.Windows.Media.PathGeometry() 
Dim myPathFigure As new MSAvalon.Windows.Media.PathFigureQ 
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* PathFigure objects must have a defined start point before 
' other segments can be added. 

myPathFigure.StartAt(new MSAvalon.Windows.Point(200,50)) 

In the following code, the BezierTo method is used to create three Bezier curves. A fourth curve is 
created by explicitly creating a BezierSegment and adding it to myPathFigure using the AddSegment 
method. After the segments are added to the PathFigure (myPathFigure), the PathFigure is added to the 
PathGeometry. 

//C# 

myPathFigure. BezierTo( 

new Point(400, 100), new Point(400, 200), new Point(200, 300)); 

myPathFigure. BezierTo( 
new Point(400, 300), new Point(400, 100), new Point(200, 50)); 

myPathFigure. BezierTo( 

new Point(0, 100), new Point(0, 200), new Point(200,300)); 

MSAvalon. Windows. Media. BezierSegment myBezierSegment = 
new BezierSegment(new Point(0, 300), new Point(0, 100), new Point(200, 50), true); 

myPathFigure.AddSegment(myBezierSegment); 

myPathGeometry.Figures.Add(myPathFigure); 

•VB.NET 

myPathFigure. BezierTo(new MSAvalon. Windows. Point(400, 100), _ 
new MSAvalon. Windows. Point(400, 200), new MSAvalon. Windows. Point(200, 300)) 

myPathFigure. BezierTo(new MSAvalon. Windows. Point(400, 300), _ 
new MSAvalon. Windows. Point(400, 100), new MSAvalon. Windows. Point(200, 50)) 

myPathFigure. BezierTo(new MSAvalon. Windows. Point(0, 100), _ 
new MSAvalon. Windows. Point(0, 200), new MSAvalon. Windows. Point(200,300)) 

Dim myBezierSegment As new BezierSegment( _ 

new MSAvalon. Windows. Point(0, 300), new MSAvalon. Windows. Point(0, 100), _ 
new MSAvalon. Windows. Point(200, 50), true) 

myPathFigure.AddSegment(myBezierSegment) 

1 Add the PathFigure to the PathGeometry 
myPathGeometry.Figures.Add(myPathFigure) 

In the final code example, the geometries are added to a GeometryCollection, and the 
GeometryCollection is used to set the Path element's Data property. Had there been only one geometry, 
it could have been used to set the Data property directly, without the GeometryCollection. 

//C# 

GeometryCollection myGeometryCollection = new GeometryCollection(); 

myGeometryCollection.Add(myLineGeometry); 

myGeometryCollection.Add(myEllipseGeometry); 

myGeometryCollection.Add(myRectangleGeometry); 

myGeometryCollection.Add(myPathGeometry); 
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Path myPath = new Path(); 
myPath.Data = myGeometryCollection; 

// Set the outline and the fill of the Path element. 

myPath.Stroke = Brushes.Blue; 

myPath.StrokeThickness = new Length(5); 

SolidColorBrush solidFill = new SolidColorBrush(); 

myPath.Fill = new RadialGradientBrush(Colors.Orange, Colors.Red); 

// Add the Path element to a Canvas. 
myCanvas.Children.Add(myPath); 



'VB.NET 

Dim myGeometryCollection As new MSAvalon.Windows.Media.GeometryCollection() 

myGeometryCollection.Add(myLineGeometry) 

myGeometryCollection.Add(myEllipseGeometry) 

myGeometryCollection.Add(myRectangleGeometry) 

myGeometryCollection.Add(myPathGeometry) 

Dim myPath As new Path() 
myPath.Data = myGeometryCollection 

' Set the outline and the fill of the Path element. 
myPath.Stroke = MSAvalon.Windows.Media.Brushes.Biue 
myPath.StrokeThickness = new MSAvalon. Windows. Length(5) 
Dim solidFill As new MSAvalon.Windows.Media.SolidColorBrush() 
myPath.Fill = new RadialGradientBrush(MSAvalon.Windows.Media.Colors.Orange, _ 
MSAvalon.Windows.Media.Colors.Red) 

' Add the Path element to a Canvas. 
myCanvas.Children.Add(myPath) 

Geometry objects may also be rendered using the DrawingContext, which supplies a DrawGeometry 
method that may be used to render Geometry objects. Geometry objects may also be used for clippir 
and hit-testing. 



GetPageEventArgs Class 

Definition: class GetPageEventArgs 



Method 

Equals 
Finalize 

GetHashCode 

GetPageEventArgs 
GetType 

MemberwiseClone 
ReferenceEquals 



Description 

Determines whether two Object instances are equal. Inherited from Object. 
Allows an Object to attempt to free resources and perform other cleanup 
operations before the Object is reclaimed by garbage collection. Inherited from 
Object. 

Serves as a hash function for a particular type, suitable for use in hashing 
algorithms and data structures like a hash table. Inherited from Object. 
Constructor 

Gets the Type of the current instance. Inherited from Object. 
Creates a shallow copy of the current Object. Inherited from Object. 
Determines whether the specified Object instances are the same 
instance. Inherited from Object. 
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ToString Returns a String that represents the current Object. Inherited from Object. 

Property Description 



JobTicket 



JobTicket property 



GlyphRun Class 

Definition: Glyph Run Class. 



Method 

BuildGeometry 

Equals 

Finalize 

GetHashCode 

GetType 

GlyphRun 

IsErnpty 

MemberwiseClone 
ReferenceEquals 

ToString 



Description 

Obtains geometry for the glyph run. 

Determines whether two Object instances are equal. Inherited from Object. 
Finalizer 

Serves as a hash function for a particular type, suitable for use in hashing 

algorithms and data structures like a hash table. Inherited from Object. 

Gets the Type of the current instance. Inherited from Object. 

Constructs a glyph run from a string 

Returns whether GlyphRun doesn't contain any glyphs 

Creates a shallow copy of the current Object. Inherited from Object. 

Determines whether the specified Object instances are the same 
instance. Inherited from Object. 

Returns a String that represents the current Object. Inherited from Object. 



Property 

AdvanceWidth 
Ascent 

BackgroundBrush 

BidiLevel 

CharacterCount 

ClusterMapOffset 

FontFace 

FontHintingEmSize 

FontRenderingEmSize 

ForegroundBrush 

GlyphCount 

Height 

InkBoundingBox 
Origin 

StyleSimulations 



Description 

Advance width from origin of first glyph to far alignment edge of last glyph. 

Distance from the GlyphRun origin to the top of the alignment box. 

Background brush, can be null 

Determines LTR/RTL reading order and bidi nesting. 

The number of characters in the glyph run 

Index of initial element in CharacterToGlyphMap 

Physical font file specification 

Em size used for hinting 

Em size used for rendering 

Foreground brush 

The number of glyphs in the glyph run 
Distance from top to bottom of alignment box. 

Computes ink bounding box for the glyph run. The rectangle is relative to the 
glyph run origin. 

Glyph run origin 

Style simulation flags 



GlyphTypeface Class 

Definition: Physical font face corresponds to a font file on the disk. 



Method 

Equals 
Finalize 



Description 

Determines whether two Object instances are equal. Inherited from Object. 
Allows an Object to attempt to free resources and perform other cleanup 
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GetGIyphOutline 



operations before the Object is reclaimed by garbage collection. Inherited from 
Object. 

Returns a geometry describing the path for a single glyph in the font. The path 
represents the glyph without grid fitting applied for rendering at a specific 
resolution. 

Serves as a hash function for a particular type, suitable for use in hashing 
algorithms and data structures like a hash table. Inherited from Object. 
Gets the Type of the current instance. Inherited from Object. 
Constructs a GlyphTypeface from a Uri 

Creates a shallow copy of the current Object. Inherited from Object. 
Determines whether the specified Object instances are the same 
instance. Inherited from Object. 

Returns a String that represents the current Object. Inherited from Object. 



GetHashCode 

GetType 
GlyphTypeface 
MemberwiseClone 

ReferenceEquals 

ToString 

Property 

AdvanceHeights 

AdvanceWidths 

Baseline 

BottomSideBearings 

CapsHeight 

CharacterToGIyphMap 

Copyrights 

Descriptions 

DesignerNames 
DesignerUrls 

DistancesFromBlackBoxLeftToVerticalBaseline 
DistancesFromHorizontalBaselineToBlackBoxBottom 

FaceNames 



Description 

Returns Advance height for a given glyph (Used for 
example in vertical layout). 

Returns advance width for a given glyph. 

Distance from cell top to English baseline relative to 
em size. 

Distance from bottom edge of black box to bottom 
end of advance vector. Positive when bottom edge 
of black box is within the alignment rectangle 
defined by the advance width and font cell height. 
(The font cell height is a horizontal dimension in 
vertical layout). Negative when bottom edge of 
black box overhangs the alignment rectangle. 

Distance from baseline to top of English capital, 
relative to em size. 

Returns nominal mapping of Unicode codepoint to 
glyph index as defined by the font 'CMAP' table. 

This property is indexed by a Culture Identifier. 
Copyright notice. 

This property is indexed by a Culture Identifier. 
Description of the typeface. Can contain revision 
information, usage recommendations, history, 
features, etc. 

This property is indexed by a Culture Identifier. 
Name of the designer of the typeface. 

This property is indexed by a Culture Identifier. 
URL of typeface designer (with protocol, e.g., 
http://, ftp://). 

Offset across from left edge of black box to East 
Asian vertical baseline. 

Offset down from horizontal Western baseline to 
bottom of glyph black box. 

This property is indexed by a Culture Identifier. It 
returns the face name in the specified language, or, 
if the font does not provide a name for the specified 
language, it returns the face name in English. The 
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FamilyNames 
Height 

LeftSideBearings 



LicenseDescriptions 
ManufacturerNames 

RightSideBearings 

SampleTexts 

StrikeoutPosition 
StrikeoutThickness 

Symbol 



TopSideBearings 



Trademarks 



UnderlinePosition 



face name may identify weight, style and/or stretch. 
This property is indexed by a Culture Identifier. It 
returns the family name in the specified language, 
or, if the font does not provide a name for the 
specified language, it returns the family name in 
English. The family name excludes weight, style 
and stretch. 

Height of character cell relative to em size. 
Distance from leading end of advance vector to left 
edge of black box. Positive when left edge of black 
box is within the alignment rectangle defined by the 
advance width and font cell height. Negative when 
left edge of black box overhangs the alignment 
rectangle. 

This property is indexed by a Culture Identifier. 
Description of how the font may be legally used, or 
different example scenarios for licensed use. This 
field should be written in plain language, not 
legalese. 

This property is indexed by a Culture Identifier. 
Manufacturer Name. 

Distance from right edge of black box to right end of 
advance vector. Positive when trailing edge of 
black box is within the alignment rectangle defined 
by the advance width and font cell height. Negative 
when right edge of black box overhangs the 
alignment rectangle. 

This property is indexed by a Culture Identifier. This 
can be the font name, or any other text that the 
designer thinks is the best sample to display the 
font in. 

Position of strikeout relative to baseline relative to 
em size. The value is usually positive, to place the 
strikeout above the baseline. 

Thickness of strikeout relative to em size. 
Returns true if this font does not conform to 
Unicode encoding: it may be considered as a 
simple collection of symbols indexed by a 
codepoint. 

Distance from top end of (vertical) advance vector 
to top edge of black box. Positive when top edge of 
black box is within the alignment rectangle defined 
by the advance height and font cell height. (The 
font cell height is a horizontal dimension in vertical 
layout). Negative when top edge of black box 
overhangs the alignment rectangle. 
This property is indexed by a Culture Identifier. This 
is used to save any trademark notice/information 
for this font. Such information should be based on 
legal advice. This is distinctly separate from the 
copyright. 

Position of underline relative to baseline relative to 
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UnderlineThickness 
VendorUrls 

Version 
VersionStrings 



Win32FaceNames 



Win32FamilyNames 



XHeight 



em size. The value is usually negative, to place the 
underline below the baseline. 

Thickness of underline relative to em size. 
This property is indexed by a Culture Identifier. 
URL of font vendor (with protocol, e.g., http://, 
ftp://). If a unique serial number is embedded in the 
URL, it can be used to register the font. 

Font face version interpreted from the font's 'NAME 
table. 

This property is indexed by a Culture Identifier. 
Version string in the fonts NAME table. Version 
strings vary significantly in format - to obtain the 
version as a numeric value use the Version 1 
property, do not attempt to parse the VersionString. 
This property is indexed by a Culture Identifier. It 
returns the face name in the specified language, or, 
if the font does not provide a name for the specified 
language, it returns the face name in English. The 
Win32Face name may identify weights other than 
regular or bold and/or style, but may not identify 
stretch or other weights. 

This property is indexed by a Culture Identifier. It 
returns the family name in the specified language, 
or, if the font does not provide a name for the 
specified language, it returns the family name in 
English. The Win32FamilyName name excludes 
regular or bold weights and style, but includes other 
weights and stretch. 

Western x-height relative to em size. 



GradientBrush Class 

Definition: An abstract class that describes a gradient fill. Classes that derive from GradientBrush 
describe different ways of interpreting gradient stops. 



Method 

AddStop 
CloneCore 

CloneCore 

CloneDownToUnchangeable 
Copy 

Copy 
Copy 



Description 

Adds a gradient stop to the brush. 

Returns a modifiable shallow or deep clone of the current object. 
This abstract method must be implemented by classes that 
derive from Changeable. Inherited from Changeable. 
Subclasses must implement this to provide clones of 
themselves. Inherited from Animatable. 

Returns an immutable copy of the specified object. Inherited 
from Changeable. 

Returns a modifiable copy of the brush. The copy's 
IsChangeable property is true and its StatusOfNextUse is 
Unchangeable. Inherited from Brush. 

Returns a modifiable copy of the brush. The copy's 
IsChangeable property is true and its StatusOfNextUse is 
Unchangeable. 

Returns a modifiable copy of the current object. The copy's 
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DeserializeFrom 
DisableCore 

EmbeddedAnimationCollectionReader 
EmbeddedAnimationCollectionWriter 
EmbeddedChangeableReader 
EmbeddedChangeableWriter 
EnableCore 

Equals 

Finalize 

GetCurrentValue 

GetCurrentValue 

GetCurrentValue 
GetHasAnimations 

GetHashCode 

GetlsAnimating 
GetlsOverridingBaseValue 
GetType 

GradientBrush 

MakeUnchangeable 

MakeUnchangeableCore 
MemberwiseClone 

ModifyHandlerlfChangeable 
OnChanged 

PropagateEventHandler 
ReadPreamble 



IsChangeable property is true and its StatusOfNextUse is 
Unchangeable. Inherited from Changeable. 
Returns a new Brush initialized from the binary representation 
being read by the passed BinaryReader. Inherited from Brush. 

Maybe this should be internal?? Inherited from Animatable. 
Inherited from Animatable. 
Inherited from Animatable. 
Inherited from Animatable. 

Determines whether two Object instances are equal. Inherited 
from Object. 

Inherited from Brush. 

Returns a non-animated version of this GradientBrush that 
represents its current state. 

Returns the current value of the brush. The returned brush has 
the same value as the current object, but doesn't vary over time; 
that is, the returned brush is a snapshot of the current object at 
the point in time at which this method was called. Inherited from 
Brush. 

Returns a non-animated version of this Animatable that 
represents its current state. Inherited from Animatable. 
Inherited from Brush. 

Serves as a hash function for a particular type, suitable for use in 
hashing algorithms and data structures like a hash 
table. Inherited from Object. 

Inherited from Brush. 

Inherited from Brush. 

Gets the Type of the current instance. Inherited from Object. 
Protected constructor for GradientBrush. Sets all values to their 
defaults. To set property values, use the constructor which 
accepts paramters 

Makes an object immutable; after this method is called on a 
Changeable, its IsChangeable property is false. Inherited from 
Changeable. 

Creates a shallow copy of the current Object. Inherited from 
Object. 

Adds or removes a Changed event handler to or from the 
specified Changeable object, if the object is currently modifiable. 
If the specified object is not modifiable— if its IsChangeable 
property is false— this method has no effect. Inherited from 
Changeable. 

Called when the current object is modified. Classes that derive 
from Changed should call this method after they have been 
modified. Inherited from Changeable. 

Ensures that simple (non-Changeable) members are being 
accessed from a valid Ul context. This method should be called 
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ReferenceEquals 
SerializeOn 

SetDefaultParentTimeline 

SetDefaultParentTimeline 

SetDefaultParentTimelineCore 
ToString 

ValidateObjectState 
WritePostscript 

WritePreamble 

Property 



before any simple members are accessed. Inherited from 
Changeable. 

Determines whether the specified Object instances are the same 
instance. Inherited from Object. 

Serialize this object using the passed writer Inherited from Brush. 
Inherited from Brush. 

This will change the time parent for animations on any of the 
properties of this Changeable which are inheriting their time 
parent. Inherited from Animatable. 

Returns a String that represents the current Object. Inherited 
from Object. 

Verifies that the current object has a valid state. If the object is in 
an invalid state, this method throws an exception. Inherited from 
Changeable. 

Causes the current object to validate itself and then invokes the 
OnChanged method. Inherited from Changeable. 
Ensures that simple (non-Changeable) members are being 
accessed from a valid user interface (Ul) context. This method 
should be called before any simple members are set. Inherited 
from Changeable. 



Description 

Used in conjunction with the ChangeableUsageOverride type sent in 
AllowChangeableReferenceOverride as a P arameter t0 ChangeableHelper.UseChangeable, to help 

determine when a Changeable being put into "use" should be 
promoted to "ChangeableReference". Inherited from Changeable. 

True if this Changeable can be made unchangeable. Inherited from 
Changeable. 

ColorlnterpolationMode - Read only accessor of the 
ColorlnterpolationMode property. This property controls how the 
colors in Gradient are interpolated. Default is 
ColorlnterpolationMode.PerceptuallyLinearGamma. 
The current parent Timeline associated with this Animatable. This 
will be the Timeline set to the ParentTimeline property of this 
Animatable if one has been set and if not, the Timeline last passed 
into the SetDefaultParentTimeline method. Inherited from 
Animatable. 



CanMakeUnchangeable 



ColorlnterpolationMode 



DefaultParentTimeline 



GradientStops 

HasAnimations 

IsAnimating 

IsChangeable 

IsOverridingBaseValue 

MappingMode 

Opacity 

OpacityAnimations 



Gets or sets the gradient stops (transition points) of a brush. 
Gets a Boolean that indicates whether the brush has animations. 

Gets a Boolean that indicates whether the object is currently 
modifiable. Inherited from Changeable. 

Gets or sets a BrushMappingMode enumeration that specifies 
whether the gradient brush's positioning coordinates are absolute or 
relative to the output area. 

Gets or sets the degree of opacity of a Brush. Inherited from Brush. 
Gets or sets the animations associated with the Opacity of the 
brush. Inherited from Brush. 
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SpreadMethod 



Gets or sets the type of spread method that specifies how to draw a 
gradient that starts or ends inside the bounds of the object to be 
painted. 



Transform 



StatusOfNextUse 



Gets or sets a UseStatus enumeration that specifies how the 
Changeable object behaves when it is "used." A Changeable object 
is considered used in the following situations: the object is set into a 
Property System property, the object is used as a sub-object in a 
complex Changeable object, or the object is used in a 
DrawingContext command. Inherited from Changeable. 
Gets or sets a transformation that is applied to the brush. This 
transformation is applied after all other mapping and positioning 
have been processed. Inherited from Brush. 



UlContext 



Gets the UlContext of the current object The UlContext is used for 
maintaining thread safety. Inherited from Changeable. 



This example demonstrates how to use the Transform property of brushes to apply transformations to 
LinearGradientBrush and RadialGradientBrush fills. A LinearGradientBrush is used to fill the first two 
Rectangle elements. The difference between the rectangles is that the LinearGradientBrush in the second 
rectangle is rotated 45 degrees. The second pair of rectangles illustrates the before and after effect of a 
ScaleTransform by reducing a RadialGradientBrush to half its normal height. 

<Border xmlns= ,, http://schemas.microsoft.com/2003/xam^ , 
Background= M #CCCCCC"> 

<Canvas Height="40 ,, > 

<!- Rectangle #1 is filled with a LinearGradientBrush. The gradient colors 
flow from left to right by default. -> 

<Rectangle RectangleLeft="10" RectangleTop="10" 
RectangleWidth= n 300" RectangleHeight="200 M > 

<Rectangle.Fill> 
<LinearGradientBrush> 

<LinearGradientBrush.GradientStops> 
<GradientStopCollection> 
<GradientStop Color="red" Offset= ,, 07> 
<GradientStop Color="yellow" Offset="1 M /> 
<GradientStop Color="blue" Offset="0.57> 
<GradientStop Color="white" Offset="0.27> 
</GradientStopCollection> 
</LinearGradientBrush.GradientStops> 

</LinearGradientBrush> 
</Rectangle.Fill> 

</Rectangle> 



<!- Rectangle #2 is identical to the first rectangle except that the Transform 
property rotates the LinearGradientBrush so that the gradient colors are 
rotated by 45 degrees. — > 

<Rectangle RectangleLeft= n 320" RectangleTop= M 10" 
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RectangleWidth= n 300" RectangleHeight= M 200 M > 



<Rectangle.Fill> 
<LinearGradientBrush> 

<LinearGradientBrushTransform> 
<RotateTransform Angle="45" /> <!- Rotation angle. -> 
</LinearGradientBrush.Transform> 

<LinearGradientBrush.GradientStops> 
<GradientStopCollection> 
<GradientStop Color="red" Offset="07> 
<GradientStop Color="yellow" Offset="1" /> 
<GradientStop Color= M blue" Offset="0.57> 
<GradientStop Color="white" Offset="0.27> 
</GradientStopCollection> 
</LinearGradientBrush.GradientStops> 

</LinearGradientBrush> 
</Rectangle.Fill> 

</Rectangle> 



<!- Rectangle #3 is filled with a RadialGradientBrush. -> 

<Rectangle RectangleLeft="10" RectangleTop="250" 
RectangleWidth="300 H RectangleHeight= ,, 200"> 

<Rectangle.Fill> 
<RadialGradientBrush Focus="0.5,0.5"> 

<RadialGradientBrush.GradientStops> 
<GradientStopCollection> 
<GradientStop Color="red" Offset= M 0 M /> 
<GradientStop Color="yellow" Offset="17> 
<GradientStop Color="blue" Offset= M 0.57> 
</GradientStopCollection> 
</RadialGradientBrush.GradientStops> 

</RadialGradientBaish> 
</Rectangle.Fill> 

</Rectangle> 



<!- Rectangle #4 is identical to the third rectangle except that the Transform 
property applies a ScaleTransform to the RadialGradientBrush so that the 
gradient is half its previous height. ~> 

<Rectangle RectangleLeft="320" RectangleTop="250" 
RectangleWidth="300" RectangleHeight="200"> 

<Rectangle.Fill> 

<RadialGradientBrush Focus="0.5,0.5"> 
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<RadialGradientBrush.Transform> 
<ScaleTransform ScaleX="1" ScaleY="0.5" /><!-- Scale transform. ~> 
</RadialGradientBrush.Transform> 

<RadialGradientBrush.GradientStops> 
<GradientStopCollection> 
<GradientStop Color="red" Offset="07> 
<GradientStop Color="yellow" Offset= M 17> 
<GradientStop Color= n blue" Offset="0.57> 
</GradientStopCollection> 
</RadiaIGradientBrush.GradientStops> 

</RadialGradientBrush> 
</Rectangle.Fill> 

</Rectangle> 

</Canvas> 
</Border> 



This example creates simple vertical, horizontal, and radial gradients and uses them to fill an element 
using "Longhorn" markup language (code-named "XAML"). 

In the following example, vertical and horizontal gradients are used to set the Fill property of two 
Rectangle elements. In this particular example, the gradients are described using simple notation: 
GradientType StartColor EndColor, where GradientType is VerticalGradient, HorizontalGradient, or 
RadialGradient. StartColor and EndColor can be predefined color names (such as Blue) or hexadecimal 
values. 

<Canvas xmins= ,, http://schemas.microsoft.com/2003/xaml ,, > 

<Rectangle 

Fill="VerticalGradient Blue Green" 

RectangleLeft= M 20 n 

RectangleTop="20" 

RectangleWidth="100" 

RectangleHeight="100"> 
</Rectangle> 

<Rectangle 

Fill="HorizontaIGradient Blue Red" 

RectangleLeft="120" 

RectangleTop="120 H 

RectangleWidth="100" 

RectangleHeight="100"> 
</Rectangle> 

A vertical gradient is a linear gradient whose start and endpoints form a vertical line; likewise, a horizontal 
gradient is a linear gradient whose start and endpoints form a horizontal line. You can explicitly describe 
your own linear gradients using the following syntax: 

LinearGradient StartPoint EndPoint StartColor EndColor, where StartPoint and EndPoint are the starting 
and ending coordinates, with each coordinate expressed as a pair of x and y values from 0 to 1, such as 
0.1,0.1 and 0.5,0.5. These values indicate the relative position of the start or end point. An endpoint of 
0.5,0.5 would be located 50 percent to the right of the fill area and 50 percent of the way from the top of 
the area— the middle of the shape. 
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In the following example, the Fill property of a Rectangle element is set by explicitly using a linear 
gradient. 

<Rectangle 

Fill="LinearGradient 0.1,0.1 0.5,0.5 Blue Green" 
RectangleLeft="220" 
RectangleTop="220" 
RectangleWidth= M 100" 
RectangleHeight="100"> 
</Rectangle> 

In the final example, the Fill property of a Rectangle element is set using a radial gradient. 

<Rectangle 

Fill="RadialGradient Blue Red" 

RectangleLeft= ,, 320 u 

RectangleTop="320" 

RectangleWidth="100" 

RectangleHeight= M 100"> 
</Rectangle> 

</Canvas> 

See Create a Gradient with More Than Two Colors for an example of how to create a gradient with more 
than two gradient stops. 

To create vertical and horizontal gradients in code or using compound notation, use the 
LinearGradientBrush class and set its StartPoint and EndPoint properties so that they describe a vertical 
or horizontal line. To create radial gradients in code or using compound notation, use the 
RadialGradientBrush class. 

This example demonstrates how to create a gradient that has more than two colors in "XAML". To create 
a gradient with more than two colors, add a GradientStopCollection to the gradient's GradientStops 
property. Next, add GradientStop objects to the GradientStopCollection, one for each color the gradient 
should contain. Set the Color and the Offset, a value from 0 to 1 that determines the relative position of 
the stop in the gradient, of each of the stops. The following example shows a Button whose Background 
is filled with a horizontal gradient that has four colors. 

<Canvas ID="root" 

xmlns= ,, http://schemas.microsoft.com/2003/xaml ,, > 
< Button 

Canvas.Top="50" 
Canvas. Left="50" 
BorderBrush="Black" 
Width= M 200" 
Height="30"> 
<Button. Background> 
<LinearGradientBrush > 
<LinearGradientBrush.GradientStops> 
<GradientStopCollection> 
<GradientStop Color="Red" Offset="0 M /> 
<GradientStop Color="Blue" Offset="0.257> 
<GradientStop Color= n Orange" Offset="0.757> 
<GradientStop Color= M Yellow" Offset="17> 
</GradientStopCollection> 
</LinearGradientBrush.GradientStops> 
</LinearGradientBrush> 
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</Button.Background> 
</Button> 



</Canvas> 



GradientStop Class 

Definition: Describes the location and color of a transition point in a gradient. 



Method 

CloneCore 
CloneCore 

CloneDownToUnchangeable 

Copy 
Copy 

DisableCore 

EmbeddedAnimationCollectionReader 
EmbeddedAnimationCollectionWriter 
EmbeddedChangeableReader 
EmbeddedChangeableWriter 
EnableCore 

Equals 
Finalize 

GetCurrentValue 
GetCurrentValue 

GetHashCode 



GetType 
GradientStop 

MakeUnchangeable 

MakeUnchangeableCore 
MemberwiseClone 

ModifyHandlerlfChangeable 



Description 

Returns a modifiable shallow or deep clone of the current object. 
This abstract method must be implemented by classes that 
derive from Changeable, Inherited from Changeable. 
Implementation of Animatable.CloneCore. 

Returns an immutable copy of the specified object. Inherited 
from Changeable. 

Returns a modifiable copy of the current object. The copy's 
IsChangeable property is true and its StatusOfNextUse is 
Unchangeable. Inherited from Changeable. 
Creates a copy of this GradientStop. 

Maybe this should be internal?? Inherited from Animatable. 
Inherited from Animatable. 
Inherited from Animatable. 
Inherited from Animatable. 

Determines whether two Object instances are equal. Inherited 
from Object. 

Allows an Object to attempt to free resources and perform other 
cleanup operations before the Object is reclaimed by garbage 
collection. Inherited from Object. 

Returns a non-animated version of this Animatable that 
represents its current state. Inherited from Animatable. 

Returns a non-animated version of this GradientStop that 
represents its current state. 

Serves as a hash function for a particular type, suitable for use in 
hashing algorithms and data structures like a hash 
table. Inherited from Object. 

Gets the Type of the current instance. Inherited from Object. 
Initializes a new instance of the GradientStop class. 
Makes an object immutable; after this method is called on a 
Changeable, its IsChangeable property is false. Inherited from 
Changeable. 

Creates a shallow copy of the current Object. Inherited from 
Object. 

Adds or removes a Changed event handler to or from the 
specified Changeable object, if the object is currently modifiable. 
If the specified object is not modifiable — if its IsChangeable 
property is false— this method has no effect. Inherited from 
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OnChanged 

PropagateEventHandler 
ReadPreamble 

ReferenceEquals 

SetDefaultParentTimeline 

SetDefaultParentTimelineCore 
ToString 

ValidateObjectState 
WritePostscript 

WritePreamble 



Changeable. 

Called when the current object is modified. Classes that derive 
from Changed should call this method after they have been 
modified. Inherited from Changeable. 

Implementation of PropagateEventHandler. 

Ensures that simple (non-Changeable) members are being 

accessed from a valid Ul context. This method should be called 

before any simple members are accessed. Inherited from 

Changeable. 

Determines whether the specified Object instances are the same 
instance. Inherited from Object. 

This will change the time parent for animations on any of the 
properties of this Changeable which are inheriting their time 
parent. Inherited from Animatable. 

Returns a String that represents the current Object. Inherited 
from Object. 

Verifies that the current object has a valid state. If the object is in 
an invalid state, this method throws an exception. Inherited from 
Changeable. 

Causes the current object to validate itself and then invokes the 
OnChanged method. Inherited from Changeable. 
Ensures that simple (non-Changeable) members are being 
accessed from a valid user interface (Ul) context. This method 
should be called before any simple members are set. Inherited 
from Changeable. 



Property Description 

Used in conjunction with the ChangeableUsageOverride type sent in 

AllowChangeableReferenceOverride * s a P arameter to ChangeableHelper.UseChangeable, to help 

determine when a Changeable being put into "use" should be 
promoted to "ChangeableReference". Inherited from Changeable. 

True if this Changeable can be made unchangeable. Inherited from 
Changeable. 

Gets or sets the color value of the gradient stop. 

Gets or sets the animations associated with the Color of the 
gradient stop. 

The current parent Timeline associated with this Animatable. This 
will be the Timeline set to the ParentTimeline property of this 
Animatable if one has been set and if not, the Timeline last passed 
into the SetDefaultParentTimeline method. Inherited from 
Animatable. 



CanMakeUnchangeable 
Color 

ColorAnimations 



DefaultParentTimeline 



HasAnimations 

IsAnimating 

IsChangeable 

IsOverridingBaseValue 
Offset 



Gets a Boolean that indicates whether the gradient stop has 
animations. 



Gets a Boolean that indicates whether the object is currently 
modifiable. Inherited from Changeable. 

Gets the location of the gradient stop within the gradient vector. 
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UlContext 



StatusOfNextUse 



OffsetAnimations 



Gets or sets a collection of objects that animate the gradient stop's 
offset. 

Gets or sets a UseStatus enumeration that specifies how the 
Changeable object behaves when it is "used." A Changeable object 
is considered used in the following situations: the object is set into a 
Property System property, the object is used as a sub-object in a 
complex Changeable object, or the object is used in a 
DrawingContext command. Inherited from Changeable. 

Gets the UlContext of the current object. The UlContext is used for 
maintaining thread safety. Inherited from Changeable. 



This example demonstrates how to create a gradient that has more than two colors in "Longhorn" markup 
language (code-named "XAML"). To create a gradient with more than two colors, add a 
GradientStopCollection to the gradient's GradientStops property. Next, add GradientStop objects to the 
GradientStopCollection, one for each color the gradient should contain. Set the Color and the Offset, a 
value from 0 to 1 that determines the relative position of the stop in the gradient, of each of the stops. The 
following example shows a Button whose Background is filled with a horizontal gradient that has four 
colors. 

<Canvas ID="root" 
xmlns= ,, http://schemas.microsoft.com/2003/xaml"> 

<Button 

Canvas.Top="50" 
Canvas. Left="50" 
BorderBrush="Black" 
Width="200" 
Height="30"> 
<Button. Background> 
<LinearGradientBrush > 
<LinearGradientBrush.GradientStops> 
<GradientStopCollection> 
<GradientStop Color="Red" Offset="0 M /> 
<GradientStop Color="Blue M Offset="0.25"/> 
<GradientStop Color="Orange H Offset="0.75'7> 
<GradientStop Color="Yellow" Offset='T7> 
</GradientStopCollection> 
</LinearGradientBrush.GradientStops> 
</LinearGradientBrush> 
</Button.Background> 
</Button> 

</Canvas> 



GradientStopCollection Class 

Definition: Represents a collection of GradientStop gradient stops. 



Method 



Description 

Adds a GradientStop to the gradient stop collection. 



Add 

AddRange 
Clear 



Removes all items from the gradient stop list. 

Returns a modifiable shallow or deep clone of the current object. 

This abstract method must be implemented by classes that 



CloneCore 
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CloneCore 

CloneDownToUnchangeable 
Contains 

Copy 



Copy 
CopyTo 
DisableCore 

EmbeddedAnimationCollectionReader 
EmbeddedAnimationCollectionWriter 
EmbeddedChangeableReader 
EmbeddedChangeableWriter 
EnableCore 

Equals 
Finalize 

GetCurrentValue 
GetCurrentValue 
GetEnumerator 

GetHashCode 

GetRange 
GetType 

GradientStopCollection 
lAddChild.AddChild 
lAddChild.AddText 

IList.Add 

IListContains 
IList.lndexOf 
IList.lnsert 
IListRemove 
IndexOf 

Insert 



derive from Changeable. Inherited from Changeable. 

Returns an immutable copy of the specified object. Inherited 
from Changeable. 

Determines whether the collection contains the specified 
GradientStop. 

Returns a modifiable copy of the current object. The copy's 
IsChangeable property is true and its StatusOfNextUse is 
Unchangeable. Inherited from Changeable. 

Copies the entire GradientStopCollection to a compatible one- 
dimensional Array, starting at the specified index of the target 
array. 

Maybe this should be internal?? Inherited from Animatable. 
Inherited from Animatable. 
Inherited from Animatable. 
Inherited from Animatable. 

Determines whether two Object instances are equal. Inherited 
from Object. 

Allows an Object to attempt to free resources and perform other 
cleanup operations before the Object is reclaimed by garbage 
collection. Inherited from Object. 

Returns a non-animated version of this GradientStopCollection 
that represents its current state. 

Returns a non-animated version of this Animatable that 
represents its current state. Inherited from Animatable. 

Returns an enumerator that can iterate through the entire 
GradientStopCollection collection. 

Serves as a hash function for a particular type, suitable for use in 
hashing algorithms and data structures like a hash 
table. Inherited from Object. 

Gets the Type of the current instance. Inherited from Object. 
Initializes a new instance of the GradientStopCollection class. 



Adds an item to the gradient stop list. Functions identically to 
Add, except that an exception is returned if the item is not the 
proper type. 



Returns the zero-based index of the specified GradientStop. 

Inserts a GradientStop at the specified position in the gradient 
stop list. 



109 



InsertRange 
LastlndexOf 

MakeUnchangeable 

MakeUnchangeableCore 
MemberwiseClone 



ModifyHandlerlfChangeable 
OnChanged 

PropagateEventHandier 
ReadPreamble 

ReferenceEquals 

Remove 

RemoveAt 
RemoveRange 

SetDefaultParentTimeline 

SetDefaultParentTimelineCore 
SetRange 

ToString 

ValidateObjectState 
WritePostscript 

WritePreamble 

Property 



Makes an object immutable; after this method is called on a 
Changeable, its IsChangeable property is false. Inherited from 
Changeable. 

Implementation of MakeUnchangeableCore. 

Creates a shallow copy of the current Object. Inherited from 

Object. 

Adds or removes a Changed event handler to or from the 
specified Changeable object, if the object is currently modifiable 
If the specified object is not modifiable— if its IsChangeable 
property is false— this method has no effect. Inherited from 
Changeable. 

Called when the current object is modified. Classes that derive 
from Changed should call this method after they have been 
modified. Inherited from Changeable. 
Implementation of PropagateEventHandier. 
Ensures that simple (non-Changeable) members are being 
accessed from a valid Ul context. This method should be called 
before any simple members are accessed. Inherited from 
Changeable. 

Determines whether the specified Object instances are the same 
instance. Inherited from Object. 

Removes the first occurrence of the specified GradientStop from 
the collection. 

Removes the item at the specified index in the collection. 

This will change the time parent for animations on any of the 
properties of this Changeable which are inheriting their time 
parent. Inherited from Animatable. 



Returns a String that represents the current Object. Inherited 
from Object. 

Verifies that the current object has a valid state. If the object is in 
an invalid state, this method throws an exception. Inherited from 
Changeable. 

Causes the current object to validate itself and then invokes the 
OnChanged method. Inherited from Changeable. 
Ensures that simple (non-Changeable) members are being 
accessed from a valid user interface (Ul) context. This method 
should be called before any simple members are set. Inherited 
from Changeable. 



Description 

Used in conjunction with the ChangeableUsageOverride type sent in 
_ as a parameter to ChangeableHelper.UseChangeable, to help 

AllowChangeableReferenceOvemde determine when a changeable being put into "use" should be 

promoted to "ChangeableReference". Inherited from Changeable. 
CanMakeUnchangeable True if this Changeable can be made unchangeable. Inherited from 
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Capacity 
Count 



DefaultParentTimeline 

HasAnimations 
IsAnimating 

IsChangeable 

IsFixedSize 
IsOverridingBaseValue 

Item 

StatusOfNextUse 
UlContext 



Changeable. 

Gets the number of items contained in the gradient stop collection. 
The current parent Timeline associated with this Animatable. This 
will be the Timeline set to the ParentTimeline property of this 
Animatable if one has been set and if not, the Timeline last passed 
into the SetDefaultParentTimeline method. Inherited from 
Animatable. 



Gets a Boolean that indicates whether the object is currently 
modifiable. Inherited from Changeable. 

Gets a value that indicates whether the collection has a fixed size. 

Gets or sets the GradientStop at the specified index in the 
collection. 

Gets or sets a UseStatus enumeration that specifies how the 
Changeable object behaves when it is "used." A Changeable object 
is considered used in the following situations: the object is set into a 
Property System property, the object is used as a sub-object in a 
complex Changeable object, or the object is used in a 
DrawingContext command. Inherited from Changeable. 
Gets the UlContext of the current object. The UlContext is used for 
maintaining thread safety. Inherited from Changeable. 



This example demonstrates how to create a gradient that has more than two colors in "Longhorn" markup 
language (code-named "XAML"). To create a gradient with more than two colors, add a 
GradientStopCollection to the gradient's GradientStops property. Next, add GradientStop objects to the 
GradientStopCollection, one for each color the gradient should contain. Set the Color and the Offset, a 
value from 0 to 1 that determines the relative position of the stop in the gradient, of each of the stops. The 
following example shows a Button whose Background is filled with a horizontal gradient that has four 
colors. 



<Canvas ID="root" 

xmlns="http://schemas.microsoft.com/2003/xamr , > 
<Button 

Canvas.Top="50" 
Canvas. Left="50" 
BorderBrush="Black" 
Width= M 200" 
Height="30"> 
<Button.Background> 
<LinearGradientBrush > 
<LinearGradientBrush.GradientStops> 
<GradientStopCollection> 
<GradientStop Color= n Red" Offset="0" /> 
<GradientStop Color="Blue" Offset= M 0.25'7> 
<GradientStop Color="Orange M Offset^'O^S"^ 
<GradientStop Color= M Yellow" Offset= ,, 1"/> 
</GradientStopCollection> 
</LinearGradientBrush.GradientStops> 
</LinearGradientBrush> 
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</Button. Background 
</Button> 



</Canvas> 



HitTestParameters Class 

Definition: This is the base class for packing together parameters for a hit test pass. 



Method Description 

Equals Determines whether two Object instances are equal. Inherited from Object. 

Allows an Object to attempt to free resources and perform other cleanup 
Finalize operations before the Object is reclaimed by garbage collection. Inherited from 

Object. 

GetHashCode Serves as a hash function for a particular type, suitable for use in hashing 

algorithms and data structures like a hash table. Inherited from Object. 
GetType Gets the Type of the current instance. Inherited from Object. 

MemberwiseClone Creates a shallow copy of the current Object. Inherited from Object. 

Determines whether the specified Object instances are the same 
instance. Inherited from Object. 



ReferenceEquals 
ToString 



Returns a String that represents the current Object. Inherited from Object. 



HitTestResult Class 

Definition: This base returns the visual that was hit during a hit test pass. 



Method 

Equals 

Finalize 

GetHashCode 
GetType 

MemberwiseClone 

ReferenceEquals 

ToString 



Description 

Determines whether two Object instances are equal. Inherited from Object. 
Allows an Object to attempt to free resources and perform other cleanup operations 
before the Object is reclaimed by garbage collection. Inherited from Object. 
Serves as a hash function for a particular type, suitable for use in hashing 
algorithms and data structures like a hash table. Inherited from Object. 
Gets the Type of the current instance. Inherited from Object. 
Creates a shallow copy of the current Object. Inherited from Object. 

Determines whether the specified Object instances are the same instance. Inherited 
from Object. 

Returns a String that represents the current Object. Inherited from Object. 
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Hwndlnterop Class 

Definition: Hwndlnterop 

Method Description 

AttachChildWindow AttachChildWindow 
BeginPaint BeginVisualPaint 
EndPaint EndVisualPaint 

Equals Determines whether two Object instances are equal. Inherited from Object. 

Finalize Allows an Object to attempt to free resources and perform other cleanup operations 

before the Object is reclaimed by garbage collection. Inherited from Object. 
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GetHashCode 

GetHwnd Parent 
GetType 
Hwndlnterop 
I nit 

InitWindow 
MemberwiseClone 

ReferenceEquals 

Shutdown 
ToString 



Serves as a hash function for a particular type, suitable for use in hashing 
algorithms and data structures like a hash table. Inherited from Object. 
GetHwndParent 

Gets the Type of the current instance. Inherited from Object. 

InitHwndSupport 
InitWindow 

Creates a shallow copy of the current Object. Inherited from Object. 

Determines whether the specified Object instances are the same 
instance. Inherited from Object. 

ShutdownHwndSupport 

Returns a String that represents the current Object. Inherited from Object. 



HwndVisual Class 



Method 

ClearValue 

Equals 

Finalize 

FindCommonVisualAncestor 

GetHashCode 

GetHwndVisual 

GetLocalValueEnumerator 

GetType 
GetValue 

HitTest 

HitTestCore 

InvalidateProperty 

IsAncestorOf 

IsDescendantOf 

I Visual. FindCommonVisualAncestor 

IVisual.HitTest 

I Visual. IsAncestorOf 

IVisual.lsDescendantOf 

IVisual.TransformFromAncestor 



Description 

Clears the local value of a property Inherited from 
DependencyObject. 

Determines whether two Object instances are equal. Inherited from 
Object. 

Releases all resources held by the Visual object. Inherited from 
Visual. 

Re-exposes the Visual base class's corresponding IVisual 
implementation as public method. Inherited from ContainerVisual. 
Serves as a hash function for a particular type, suitable for use in 
hashing algorithms and data structures like a hash table. Inherited 
from Object. 

GetHwndVisual 

Create a local value enumerator for this instance Inherited from 
DependencyObject. 

Gets the Type of the current instance. Inherited from Object. 
Retrieve the value of a property Inherited from DependencyObject. 
Re-exposes the Visual base class's corresponding IVisual 
implementation as public method. Inherited from ContainerVisual. 

HitTestCore implements whether we have hit the bounds of this 
visual. Inherited from Visual. 

Invalidates a property Inherited from DependencyObject. 
Re-exposes the Visual base class's corresponding IVisual 
implementation as public method. Inherited from ContainerVisual. 
Re-exposes the Visual base class's corresponding IVisual 
implementation as public method. Inherited from ContainerVisual. 
Inherited from Visual. 
Inherited from Visual. 
Inherited from Visual. 
Inherited from Visual. 
Inherited from Visual. 
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IVisual.TransformFromDescendant 

IVisual.TransformFromVisual 

IVisual.TransformToAncestor 

IVisual.TransformToDescendant 

IVisualTransformToVisual 

MemberwiseClone 

OnDelayedlnvalidate 

OnPropertylnvalidated 

ReadLocalValue 

ReferenceEquals 

SetContext 

SetValue 

ToString 

Transform From Ancestor 
TransformFromDescendant 
TransformFromVisual 

TransformToAncestor 

TransformToDescendant 

TransformToVisua! 
ValidateProperty 

ValidatePropertyCore 



Inherited from Visual. 
Inherited from Visual. 
Inherited from Visual. 
Inherited from Visual. 
Inherited from Visual. 

Creates a shallow copy of the current Object. Inherited from 
Object. 

TODO: Left over from WCP FastBuild, determine relevance in 
future version of FastBuild Inherited from DependencyObject. 

Notification that a specified property has been invalidated Inherited 
from DependencyObject. 

Retrieve the local value of a property (if set) Inherited from 
DependencyObject. 

Determines whether the specified Object instances are the same 
instance. Inherited from Object. 

Associates this UlContextObject with a UlContext. Inherited from 
UlContextObject. 

Sets the local value of a property Inherited from 
DependencyObject. 

Returns a String that represents the current Object. Inherited from 
Object. 

Re-exposes the Visual base class's corresponding IVisual 
implementation as public method. Inherited from ContainerVisual. 
Re-exposes the Visual base class's corresponding IVisual 
implementation as public method. Inherited from ContainerVisual. 
Re-exposes the Visual base class's corresponding IVisual 
implementation as public method. Inherited from ContainerVisual. 
Returns a Matrix object that represents the aggregate 
transformation from the coordinates of a Visual to the specified 
ancestor. Inherited from ContainerVisual. 

Returns a transformation matrix that can be used to transform 
coordinates from this node to a specified descendant 
Visual. Inherited from ContainerVisual. 

Re-exposes the Visual base class's corresponding IVisual 
implementation as public method. Inherited from ContainerVisual. 
Retrieve the value of a property (for use by native cache backed 
custom get accessors) Inherited from DependencyObject. 
Allows subclasses to participate in property value 
computation Inherited from DependencyObject. 



Property 

Children 

Clip 

Context 



Description 

Gets a collection of the ContainerVisual's children. Inherited from 
ContainerVisual. 

Gets or sets the clipping region of this ContainerVisual. Inherited from 
ContainerVisual. 

Returns the UlContext that this UlContextObject is associated with. Inherited 
from UlContextObject. 



DeoendencvObiectTvoe Returns the DT YPe that represents the CLR type of this instance Inherited from 
7 J yp DependencyObject. 
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Handle 
HasChildren 

HitTestBounds 

IsDisposed 

IsHwndDpiAware 

Opacity 

Parent 

Size 



Handle 

Gets a value that indicates whether the ContainerVisual has a child 
collection. Inherited from ContainerVisual. 

HitBounds returns the hit region bounding box for the current visual. Inherited 
from Visual. 

Gets a value that indicates whether the system has disposed of the 
Visual. Inherited from Visual. 

IsHwndDpiAware 

Gets or sets the opacity of the ContainerVisual. Inherited from ContainerVisual. 

Gets the parent Visual. Inherited from ContainerVisual. 

Size 



HyphenationCandidate Class 

Definition: Describes one Hyphenation candidate. 

Description 

Determines whether two Object instances are equal. Inherited from Object. 
Allows an Object to attempt to free resources and perform other cleanup 
operations before the Object is reclaimed by garbage collection. Inherited from 
Object. 

Serves as a hash function for a particular type, suitable for use in hashing 
algorithms and data structures like a hash table. Inherited from Object. 
Gets the Type of the current instance. Inherited from Object. 
Ctor to create a new Hyphenation candidate 
Creates a shallow copy of the current Object Inherited from Object 

Determines whether the specified Object instances are the same 
instance. Inherited from Object. 

Returns a String that represents the current Object. Inherited from Object. 



Property Description 

First Get the first character to be inserted (if exist) 

Index Get the zero-based index of hyphenation position 

Rule Get the rule of this hyphenation 

Second Get the second character to be inserted (if exist) 



Method 

Equals 
Finalize 

GetHashCode 
GetType 

HyphenationCandidate 
MemberwiseClone 

ReferenceEquals 
ToString 



ICCProfile Class 
Method 

Equals 

Finalize 

FixEndian 

GetHashCode 

GetlCCSignature 



Description 

Determines whether two Object instances are equal. Inherited from Object. 
Allows an Object to attempt to free resources and perform other cleanup 
operations before the Object is reclaimed by garbage collection. Inherited from 
Object. 

Serves as a hash function for a particular type, suitable for use in hashing 
algorithms and data structures like a hash table. Inherited from Object. 
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GetType 
ICCsigned1516 
ICCWriteSigned1516 
MemberwiseClone 

ReferenceEquals 

SetiCCSignature 
ToString 



Gets the Type of the current instance. Inherited from Object. 



Creates a shallow copy of the current Object. Inherited from Object. 

Determines whether the specified Object instances are the same 
instance, inherited from Object. 

Returns a String that represents the current Object Inherited from Object. 



ImageBrush Class 

Definition: Fills an area with an image. This class may be used to specify images as the fill or background 
of other objects. 



Method 

CloneCore 
CloneCore 

CloneDownToUnchangeable 

Copy 
Copy 

Copy 
Copy 

DeserializeFrom 
DisableCore 

EmbeddedAnimationCollectionReader Maybe this should be internal?? inherited from Animatabie. 
EmbeddedAnimationCollectionWriter Inherited from Animatabie. 
EmbeddedChangeableReader Inherited from Animatabie. 

EmbeddedChangeableWriter Inherited from Animatabie. 



Description 

Implementation of Animatable.CloneCore. 

Returns a modifiable shallow or deep clone of the current object. 
This abstract method must be implemented by classes that 
derive from Changeable. Inherited from Changeable. 

Returns an immutable copy of the specified object. Inherited from 
Changeable. 

Returns a modifiable copy of the brush. The copy's IsChangeable 
property is true and its StatusOfNextUse is Unchangeable. 
Creates a copy of this TileBrush. Inherited from TileBrush. 

Returns a modifiable copy of the brush. The copy's IsChangeable 
property is true and its StatusOfNextUse is 
Unchangeable. Inherited from Brush. 

Returns a modifiable copy of the current object. The copy's 
IsChangeable property is true and its StatusOfNextUse is 
Unchangeable. Inherited from Changeable. 

Returns a new Brush initialized from the binary representation 
being read by the passed BinaryReader. Inherited from Brush. 
Inherited from Brush. 



EnableCore 

Equals 

Finalize 



GetCurrentValue 



GetCurrentValue 



Inherited from Brush. 

Determines whether two Object instances are equal. Inherited 
from Object. 

Inherited from Brush. 

Returns the current value of the brush. The returned brush has 
the same value as the current object, but doesn't vary over time; 
that is, the returned brush is a snapshot of the current object at 
the point in time at which this method was called. Inherited from 
Brush. 

Returns the current value of the brush. The returned brush has 
the same value as the current object, but doesn't vary over time. 
That is, the returned brush is a snapshot of the current object at 
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GetCurrentValue 

GetCurrentValue 
GetHasAnimations 

GetHashCode 

GetlsAnimating 

GetlsOverridingBaseValue 

GetType 

ImageBrush 

MakeUnchangeable 

MakeUnchangeableCore 
MemberwiseClone 



ModifyHandlerlfChangeable 
OnChanged 

PropagateEventHandler 
ReadPreamble 

ReferenceEquals 
SerializeOn 

SetDefaultParentTimeline 

SetDefaultParentTimeline 

SetDefaultParentTimelineCore 
ToString 

ValidateObjectState 

WritePostscript 
WritePreamble 



the point in time at which this method was called. j 

Returns a non-animated version of this TileBrush that represents J 
its current state. Inherited from TileBrush. 
Returns a non-animated version of this Animatable that 
represents its current state. Inherited from Animatable. 
Inherited from Brush. 

Serves as a hash function for a particular type, suitable for use in 
hashing algorithms and data structures like a hash 
table. Inherited from Object. 

Inherited from Brush. 

Inherited from Brush. 

Gets the Type of the current instance. Inherited from Object. 

Initializes a new instance of the ImageBrush class. 

Makes an object immutable; after this method is called on a 

Changeable, its IsChangeable property is false. Inherited from 

Changeable. 

Creates a shallow copy of the current Object. Inherited from 
Object. 

Adds or removes a Changed event handler to or from the 
specified Changeable object, if the object is currently modifiable. 
If the specified object is not modifiable— if its IsChangeable 
property is false— this method has no effect. Inherited from 
Changeable. 

Called when the current object is modified. Classes that derive 
from Changed should call this method after they have been 
modified. Inherited from Changeable. 

Ensures that simple (non-Changeable) members are being 
accessed from a valid Ul context. This method should be called 
before any simple members are accessed. Inherited from 
Changeable. 

Determines whether the specified Object instances are the same 
instance. Inherited from Object. 

Serialize this object using the passed writer Inherited from Brush. 
Inherited from Brush. 

This will change the time parent for animations on any of the 
properties of this Changeable which are inheriting their time 
parent. Inherited from Animatable. 

Inherited from Brush. 

Returns a String that represents the current Object. Inherited 
from Object. 

Verifies that the current object has a valid state. If the object is in 
an invalid state, this method throws an exception. Inherited from 
Changeable. 

Causes the current object to validate itself and then invokes the 
OnChanged method. Inherited from Changeable. 
Ensures that simple (non-Changeable) members are being 
accessed from a valid user interface (Ul) context. This method 
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should be called before any simple members are set. Inherited 
from Changeable. 



Property Description 

Used in conjunction with the ChangeableUsageOverride type sent in 

AllowChangeableReferenceOverride f * P arame * er t0 ChangeableHelper.UseChangeable, to help 

determine when a Changeable being put into "use" should be 
promoted to "ChangeableReference". Inherited from Changeable. 

True if this Changeable can be made unchangeable. Inherited from 
Changeable. 

Gets or sets a BrushMappingMode enumeration that specifies 
whether the value of the brush's ViewBox— the size and position of 
the brush's content— is relative to the size of the output area. This 
property only has an effect when the size of the brush's ViewPort is 
set to RectEmpty. Inherited from TileBrush. 

The current parent Timeline associated with this Animatable. This 
will be the Timeline set to the ParentTimeline property of this 
Animatable if one has been set and if not, the Timeline last passed 
into the SetDefaultParentTimeline method. Inherited from 
Animatable. 



CanMakeUnchangeable 



ContentUnits 



DefaultParentTimeline 



HasAnimations 

HorizontalAlignment 

ImageSource 
IsAnimating 

IsChangeable 

IsOverridingBaseValue 
Opacity 

OpacityAnimations 
SizeViewBoxToContent 



StatusOfNextUse 

Stretch 

TileMode 

Transform 
UlContext 



Gets a Boolean that indicates whether the brush has 
animations. Inherited from TileBrush. 

Gets or sets a HorizontalAlignment enumeration that specifies how 
the brush's content is horizontally aligned within its tiles. Inherited 
from TileBrush. 

Gets or sets an ImageSource object that contains the image. 
Inherited from TileBrush. 

Gets a Boolean that indicates whether the object is currently 
modifiable. Inherited from Changeable. 
Inherited from TileBrush. 

Gets or sets the degree of opacity of a Brush. Inherited from Brush. 

Gets or sets the animations associated with the Opacity of the 
brush. Inherited from Brush. 

Gets a Boolean that indicates whether the image is stretched to fill 
the entire output tile. 

Gets or sets a UseStatus enumeration that specifies how the 
Changeable object behaves when it is "used." A Changeable object 
is considered used in the following situations: the object is set into a 
Property System property, the object is used as a sub-object in a 
complex Changeable object, or the object is used in a 
DrawingContext command. Inherited from Changeable. 
Gets or sets a Stretch enumeration that specifies how the brush's 
selected content (ViewBox) is displayed in the brush's tiles 
(ViewPort). Inherited from TileBrush. 

Gets or sets a TileMode structure that specifies how the brush's tiles 
fill the output area. Inherited from TileBrush. 

Gets or sets a transformation that is applied to the brush. This 
transformation is applied after all other mapping and positioning 
have been processed. Inherited from Brush. 

Gets the UlContext of the current object. The UlContext is used for 
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VerticalAlignment 
ViewBox 

ViewBoxAnimations 
ViewPort 

ViewPortAnimations 
ViewPortUnits 



maintaining thread safety. Inherited from Changeable. 

Gets or sets a VerticalAlignment enumeration that specifies how the 

brush's content is vertically aligned within its tiles. Inherited from 

TileBrush. 

Gets or sets the position and dimensions of the brush's 
content. Inherited from TileBrush. 

Gets or sets a collection of RectModifier objects that animate the 
ViewBox of the brush. Inherited from TileBrush. 

Gets or sets the position and dimensions of the brush's 
tiles. Inherited from TileBrush. 

Gets or sets a collection of RectModifier objects that animate the 
ViewPort of the brush. Inherited from TileBrush. 

Gets or sets a BrushMappingMode enumeration that specifies 
whether the value of the brush's ViewPort— the size and position of 
the brush's tiles— is relative to the size of the output area. Inherited 
from TileBrush. 



ImageCodecCollection Class 

Definition: The collection of codecs (actually Codeclnfos) on the system. 

Description 

Copies the entire ImageCodecCollection to a compatible one-dimensional Array, 
starting at the specified index of the target array. 

Determines whether two Object instances are equal. Inherited from Object. 

Allows an Object to attempt to free resources and perform other cleanup operations 
before the Object is reclaimed by garbage collection. Inherited from Object 
Returns an enumerator to iterate through the codecs. 

Serves as a hash function for a particular type, suitable for use in hashing algorithms 
and data structures like a hash table. Inherited from Object. 

Gets the Type of the current instance. Inherited from Object. 

Creates a shallow copy of the current Object. Inherited from Object. 

Determines whether the specified Object instances are the same instance. Inherited 
from Object. 

Returns a String that represents the current Object. Inherited from Object. 

Property Description 

Codecs Get the collection of codecs. 

Count Get count of codecs. 

IsSynchronized Whether this is thread-safe 

(tem Indexer for returning a specific codec from the collection. The index must be in the range: 

(Count > coded ndex >= 0) 

SyncRoot Get an object that can be used to synchronize access 



Method 

CopyTo 

Equals 

Finalize 

GetEnumerator 

GetHashCode 

GetType 

MemberwiseClone 
ReferenceEquals 

ToString 
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ImageC decEnumerator Class 

Definition: The enumerator for Image frames. 



Meth d 

CheckValidity 
Equals 

Finalize 

GetHashCode 
GetType 

MemberwiseClone 
MoveNext 

ReferenceEquals 

Reset 

ToString 



Description 

Checks for validity 

Determines whether two Object instances are equal. Inherited from Object. 
Allows an Object to attempt to free resources and perform other cleanup 
operations before the Object is reclaimed by garbage collection. Inherited from 
Object. 

Serves as a hash function for a particular type, suitable for use in hashing 
algorithms and data structures like a hash table. Inherited from Object. 
Gets the Type of the current instance. Inherited from Object. 
Creates a shallow copy of the current Object. Inherited from Object. 
MoveNext - Move to the next object in the collection. Returns false if the 
enumerator has passed the end of the collection 

Determines whether the specified Object instances are the same 
instance. Inherited from Object. 

Reset - resets the position to before the first object in the collection. A call to 

MoveNext must preceed any call to Current after a Reset. 

Returns a String that represents the current Object. Inherited from Object. 



Property Description 

Current Current - returns the current object in the collection 



ImageColorTransform Class 

Definition: ImageColorTransform Performs color management on an imaging pipeline. 



Method 



CloneCore 



Description 



CloneDownToUnchangeable 

ColorContextFromPixelFormat 

Copy 

Copy 



Returns an immutable copy of the specified object. Inherited from 
Changeable. 

Given a pixel format, this function will return the closest standard color 
space (sRGB, scRGB, etc) 

Overridden copy method for the output pin. Its job is to pull the bits from 
the Input through the color transform 

Returns a modifiable copy of the current object. The copy's 
IsChangeable property is true and its StatusOfNextUse is 
Unchangeable. Inherited from Changeable. 
Accesses the specified Changeable data member, processes it, and 
returns a reference to the member. This reference should then be 
EmbeddedChangeableReader reassigned to the original member variable. Classes that derive from 

Changeable call this method on data members before they can be 
retrieved through property calls. Inherited from Changeable. 
Processes a modified Changeable data member and returns a 
reference to the processed object. Inherited from Changeable. 

Determines whether two Object instances are equal. Inherited from 
Object. 



EmbeddedChangeableWriter 



Equals 
Finalize 
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GetDpiX 
GetDpiY 
GetFormat 

GetHashCode 

GetlnternalBitmapSource 

GetOutput 

GetPalette 

GetPixelHeight 

GetPixelWidth 



GetScaleX 



GetScaleY 
GetType 

ImageColorTransform 

MakeUnchangeable 

MakeUnchangeableCore 
MemberwiseClone 

ModifyHandlerlfChangeable 



OnChanged 

PropagateEventHandler 

ReadPreamble 

ReferenceEquals 
ToString 

ValidateObjectState 

WritePostscript 

WritePreamble 



Horizontal DPI of the image. Inherited from ImageEffect. 
Vertical DPI of the image. Inherited from ImageEffect. 
Inherited from ImageEffect. 

Serves as a hash function for a particular type, suitable for use in 
hashing algorithms and data structures like a hash table. Inherited from 
Object 

This function returns the internal bitmap source for the output pin 
Inherited from ImageEffect. 

Get a palette for a particular output Inherited from ImageEffect. 
Height, in pixels, of the image. Inherited from ImageEffect. 
Width, in pixels, of the image. Inherited from ImageEffect. 
These values contain the horizontal and vertical scale applied to this 
source. There are occasions when an effect needs to operate at a 
different resolution or a different coordinate space than the current, 
logical coordinate space. Thus, these properties enable the consumer 
to map between local space and ImageEffectSource space. Inherited 
from ImageEffect. 

Inherited from ImageEffect. 

Gets the Type of the current instance. Inherited from Object. 

Makes an object immutable; after this method is called on a 
Changeable, its IsChangeable property is false. Inherited from 
Changeable. 

Makes a Changeable object immutable. Inherited from Changeable. 
Creates a shallow copy of the current Object. Inherited from Object. 
Adds or removes a Changed event handler to or from the specified 
Changeable object, if the object is currently modifiable. If the specified 
object is not modifiable— if its IsChangeable property is false— this 
method has no effect. Inherited from Changeable. 
Called when the current object is modified. Classes that derive from 
Changed should call this method after they have been 
modified. Inherited from Changeable. 

Shares a Changed event handler with the current object's data 
members or removes it. Inherited from Changeable. 
Ensures that simple (non-Changeable) members are being accessed 
from a valid Ul context. This method should be called before any simple 
members are accessed. Inherited from Changeable. 

Determines whether the specified Object instances are the same 
instance. Inherited from Object. 

Returns a String that represents the current Object. Inherited from 
Object. 

Verifies that the current object has a valid state. If the object is in an 
invalid state, this method throws an exception. Inherited from 
Changeable. 

Causes the current object to validate itself and then invokes the 
OnChanged method. Inherited from Changeable. 
Ensures that simple (non-Changeable) members are being accessed 
from a valid user interface (Ul) context. This method should be called 
before any simple members are set. Inherited from Changeable. 
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Property Description 

Used in conjunction with the ChangeableUsageOverride type sent in 
AllowChangeableReferenceOverride as a P arameter to ChangeableHelper.UseChangeable, to help 

determine when a Changeable being put into "use" should be 
promoted to "ChangeableReference" Inherited from Changeable. 

True if this Changeable can be made unchangeable. Inherited from 
Changeable. 

This is the first input, and is an alias for lnputs[0] 
This is the collection of inputs Inherited from ImageEffect. 
Gets a Boolean that indicates whether the object is currently 
modifiable. Inherited from Changeable. 

This is the first output, and is an alias for OutputsfO] Inherited from 
ImageEffect. 

This is the collection of outputs Inherited from ImageEffect. 
Gets or sets a UseStatus enumeration that specifies how the 
Changeable object behaves when it is "used." A Changeable object 
is considered used in the following situations: the object is set into a 
Property System property, the object is used as a sub-object in a 
complex Changeable object, or the object is used in a 
DrawingContext command. Inherited from Changeable. 
Gets the UlContext of the current object. The UlContext is used for 
maintaining thread safety. Inherited from Changeable. 



CanMakeUnchangeable 

Input 
Inputs 

IsChangeable 

Output 
Outputs 



StatusOfNextUse 



UlContext 



ImageData Class 

Definition: Contains an image and related data. 

Description 

Whether the ImageSource can convert its data to the specified format. If 
not, a format converter could be used to do the conversion. Note: for 
best performance, ImageSources should provide support for 
PixelFormat32bppPARGB. 



Returns an immutable copy of the specified object. Inherited from 
CloneDownToUnchangeable Chan 9eable. 

Copy Copies the pixel data from the image into an array of pixels. Inherited 

from ImageSource. 

Returns a modifiable copy of the current object. The copy's 
Copy IsChangeable property is true and its StatusOfNextUse is 

Unchangeable. Inherited from Changeable. 

Copy a rect of pixel data from the image into the array of pixels that has 
the specified stride, starting at the pixelOffset (specified in number of 
Copy P ixels from the beginning). The pixels should be copied into the specified 

pixelFormat. To find out if the pixelFormat is supported, call 
ClosestPixelFormat first. An empty rect (one with a width and/or height 
of 0), means to ignore the rect and copy the entire image. 

Create Get the source string and any source properties from the imageData 
string and use them to construct an ImageData object. 



Method 

CanConvertTo 
CloneCore 
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EmbeddedChangeableReader 



EmbeddedChangeableWriter 

Equals 
Finalize 

GetHashCode 



GetThumbnai! 

GetType 

ImageData 

MakeUnchangeable 

MakeUnchangeableCore 
MemberwiseClone 



ModifyHandlerlfChangeable 
OnChanged 

PropagateEventHandler 
ReadPreamble 

ReferenceEquals 
ToString 

ValidateObjectState 



WritePostscript 



WritePreamble 



Accesses the specified Changeable data member, processes it, and 
returns a reference to the member. This reference should then be 
reassigned to the original member variable. Classes that derive from 
Changeable call this method on data members before they can be 
retrieved through property calls. Inherited from Changeable. 
Processes a modified Changeable data member and returns a reference 
to the processed object. Inherited from Changeable. 

Determines whether two Object instances are equal. Inherited from 
Object. 

Destroys resources associated with the object. 

Serves as a hash function for a particular type, suitable for use in 

hashing algorithms and data structures like a hash table. Inherited from 

Object. 

Returns a thumbnail of the image. Inherited from ImageSource. 
Gets the Type of the current instance. Inherited from Object. 
Initializes a new instance of the ImageData class. 
Makes an object immutable; after this method is called on a Changeable 
its IsChangeable property is false. Inherited from Changeable. 

Creates a shallow copy of the current Object. Inherited from Object. 
Adds or removes a Changed event handler to or from the specified 
Changeable object, if the object is currently modifiable. If the specified 
object is not modifiable— if its IsChangeable property is false— this 
method has no effect. Inherited from Changeable. 
Called when the current object is modified. Classes that derive from 
Changed should call this method after they have been 
modified. Inherited from Changeable. 



Ensures that simple (non-Changeable) members are being accessed 
from a valid Ul context. This method should be called before any simple 
members are accessed. Inherited from Changeable. 

Determines whether the specified Object instances are the same 
instance. Inherited from Object 

Returns a String that represents the current Object. Inherited from 
Object. 

Verifies that the current object has a valid state. If the object is in an 
invalid state, this method throws an exception. Inherited from 
Changeable. 

Causes the current object to validate itself and then invokes the 
OnChanged method. Inherited from Changeable. 
Ensures that simple (non-Changeable) members are being accessed 
from a valid user interface (Ul) context. This method should be called 
before any simple members are set. Inherited from Changeable. 



Property 



J 



Description 

Used in conjunction with the ChangeableUsageOverride type sent in 
AllowChangeableReferenceOverride as a P aramet erto ChangeableHelper.UseChangeable, to help 

determine when a Changeable being put into "use" should be 
promoted to "ChangeableReference". Inherited from Changeable. 
CanMakeUnchangeable True if this Changeable can be made unchangeable. Inherited from 



123 



Decoderlnfo 

DpiX 
DpiY 

EmbeddedColorProfile 



EmbeddedThumbnail 

Format 
Height 

InternalBitmapSource 

IsChangeable 

MetaData 

Null 

Palette 

PixelHeight 

PixelWidth 

StatusOfNextUse 

UlContext 
Width 



Changeable. 

Get the information about the specific codec that was used to 
decode the image (if there a codec was required and we have that 
information). 

Get the horizontal dpi for the Image. 
Get the vertical dpi for the Image. 

Gets the embedded color profile if one exists. Inherited from 
ImageSource. 

If there is an embedded thumbnail for the Image, return it. 
Otherwise, return null. This method does NOT create a thumbnail 
for images that don't already have one. 
Get the pixel format for the Image. 

Gets the height of the image in measure units (1/96 of an 
inch). Inherited from ImageSource. 

Returns an IMILBitmapSource interface, if there is one, and 
AddRefs it. 

Gets a Boolean that indicates whether the object is currently 
modifiable. Inherited from Changeable. 

Provides read-only access to this image's metadata. 

Gets an empty image source, i.e., an image source with 0 width and 

0 height. Inherited from ImageSource. 

Get/Sets a palette 

Get the pixel Height for the Image. 

Get the pixel width for the Image. 

Gets or sets a UseStatus enumeration that specifies how the 
Changeable object behaves when it is "used." A Changeable object 
is considered used in the following situations: the object is set into a 
Property System property, the object is used as a sub-object in a 
complex Changeable object, or the object is used in a 
DrawingContext command. Inherited from Changeable. 
Gets the UlContext of the current object. The UlContext is used for 
maintaining thread safety. Inherited from Changeable. 
Gets the width of the image in measure units (1/96 of an 
inch). Inherited from ImageSource. 



ImageDataBuilder Class 

Definition: This object is used to build an ImageData object. 



Method 

Clear 

Createlnstance 
Equals 

Finalize 

GetHashCode 
GetType 

ImageDataBuilder 



Description 

Reset the builder to its default state 
Override from Builder Class 

Determines whether two Object instances are equal, inherited from Object. 

Allows an Object to attempt to free resources and perform other cleanup operations 

before the Object is reclaimed by garbage collection. Inherited from Object. 

Serves as a hash function for a particular type, suitable for use in hashing algorithms 

and data structures like a hash table. Inherited from Object. 

Gets the Type of the current instance. Inherited from Object. 

Initializes a new instance of the ImageDataBuilder class. 
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MemberwiseClone Creates a shallow copy of the current Object Inherited from Object 

ReferenceEquals Determines whether the specified Object instances are the same instance. Inherited 

M from Object. 

TolmageData Create an ImageData from the current ImageDataBuilder properties. 

ToString Returns a String that represents the current Object Inherited from Object 



Property 

CreateCache 

Decoder! nfo 

DpiX 
DpiY 
Format 

ImageStream 

MetaData 

PixelHeight 

PixelWidth 

SizeOptions 

Source 

SourceRect 

Uri 

UseEmbeddedColorProfile 



Description 

Whether to cache the image (not used for HBitmap and Hlcon ctors). 

The decoder to use to decode the image. If null, let the system decide which 
one to use. 

Get the horizontal dpi for the Image. 
Get the vertical dpi for the Image. 
Get the pixel format for the image. 

The ImageStream property is used to specify where to get the image data 
from. 

Provides read-only access to this image's metadata. 

Get the pixel Height for the Image. 

Get the pixel width for the Image. 

How to size the image (if we're creating a cache). 

The source URI of the image to load. 

Get/Set the source rect of the image. The source rect is only used when 

creating an image from a stream, a URI/filename, or from another ImageData. 

Other ways of creating an image ignore the source rect 

The Uri property is used to specify where to get the image data from. 

Use an embedded color profile 



ImageDecoder Class 

Definition: ImageDecoder is a container for image frames. Each image frame is an ImageSource. Unlike 
ImageSource, ImageDecoder is NOT an immutable object and can be re-initialized to a different image 
stream. However, any ImageSources (frames) that it returns must be immutable. 



Method 

CopyTo 

Equals 

Finalize 

GetEnumerator 
GetFrame 

GetHashCode 
GetType 

lEnumerable.GetEnumerator 
ImageDecoder 
MemberwiseClone 
op_Explicit 



Description 

Copies the frames to an Array, starting at a particular Array index. 
Determines whether two Object instances are equal. Inherited from Object. 
Finalizerfor ImageDecoder 

Returns an enumerator to iterate through the frames of the image. 
Return an image frame, cropped by the specified sourceRect An empty 
rect (one with a width and/or height of 0), means to ignore the rect and get 
the entire frame. 

Serves as a hash function for a particular type, suitable for use in hashing 
algorithms and data structures like a hash table. Inherited from Object. 
Gets the Type of the current instance. Inherited from Object 



Creates a shallow copy of the current Object. Inherited from Object 
Conversion from ImageDecoder to ImageSource by returning the first 
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ReferenceEquals 
ToString 



frame. 

Determines whether the specified Object instances are the same 
instance. Inherited from Object. 

Returns a String that represents the current Object. Inherited from Object. 



Property 



Count 



CustomEncoderProperties 

DpiX 
DpiY 

EmbeddedColorProfile 

EmbeddedThumbnail 

Format 
Height 
Info 

IsSynchronized 
Item 

MetaData 

PixelHeight 

PixelWidth 

SyncRoot 

Width 



Description 

The number of image frames in this image. 

Returns a codec-specific object that identifies the properties that were used to 
encode this image. These codec-specific properties can be passed back to the 
associated encoder (if there is one) to get the same type of encoding again. 
This is approximate ... 

Get the horizontal dpi for the first frame. 

Get the vertical dpi for the first frame. 

If there is an embedded color profile, return it. Otherwise, return null. This 
method does NOT create a color profile for images that don't already have 
one. 

If there is an embedded thumbnail for the first frame, return it. Otherwise, 
return null. This method does NOT create a thumbnail for images that don't 
already have one. 

Get the pixel format for the first frame. 

Get the height of the image in measure units (96ths of an inch). 

The info that identifies this codec (including any associated encoder). 

A value indicating whether access to the ICollection is synchronized (thread- 
safe). 

Indexer for returning a specific frame of the image (at full size). The index 
must be in the range: (NumFrames > index >= 0) 

Provides read-only access to this image's metadata. 

Get the pixel Height for the first frame. 

Get the pixel width for the first frame. 

Gets an object that can be used to synchronize access to the ICollection. 
Get the width of the image in measure units (96ths of an inch). 



ImageDecoderBmp Class 

Definition: The built-in Microsoft Bmp (Bitmap) Decoder. 



Method 



CopyTo 



Equals 
Finalize 

GetEnumerator 

GetFrame 
GetFrame 



Description 

Copies the frames to an Array, starting at a particular Array 
index. Inherited from ImageDecoderlnternal. 

Determines whether two Object instances are equal. Inherited from 
Object. 

ImageDecoderlnternal Finalizer. Inherited from ImageDecoderlnternal. 

Returns an enumerator to iterate through the frames of the 
image. Inherited from ImageDecoder. 

Return an image frame, cropped by the specified sourceRect. An empty 
rect (one with a width and/or height of 0), means to ignore the rect and get 
the entire frame. Inherited from ImageDecoder. 

Return an image frame, with all the specified cropping and sizing applied 
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GetHashCode 
GetType 

lEnumerable.GetEnumerator 
ImageDecoderBmp 



Initialize 

MemberwiseCione 
op_Exp!icit 

ReferenceEquals 

ToString 



Property 



Count 



CustomEncoderProperties 

DpiX 
DpiY 

EmbeddedCoiorProfiie 

EmbeddedThumbnail 

Format 
Height 
Info 

IsSynchronized 
Item 

MetaData 

PixelHeight 
PixelWidth 

SyncRoot 

Width 



to it. An empty source rect (one with a width and/or height of 0), means to 
ignore the rect and get the entire frame. Inherited from 
ImageDecoderlntemal. 

Serves as a hash function for a particular type, suitable for use in hashinq 
algorithms and data structures like a hash table. Inherited from Object. 
Gets the Type of the current instance. Inherited from Object. 
Inherited from ImageDecoder. 

If this decoder cannot handle the image stream, it will throw an exception. 

Initialize the codec. Instantiate the correct unmanaged codec by using the 
supplied Guid and then initialize it to the stream. Inherited from 
ImageDecoderlntemal. 

Creates a shallow copy of the current Object. Inherited from Object. 

Conversion from ImageDecoder to ImageSource by returning the first 
frame. Inherited from ImageDecoder. 

Determines whether the specified Object instances are the same 
instance. Inherited from Object. 

Returns a String that represents the current Object. Inherited from Object. 



Description 

The number of image frames in this image. Inherited from 
ImageDecoderlntemal. 

Returns a codec-specific object that identifies the properties that were used to 
encode this image. These codec-specific properties can be passed back to the 
associated encoder (if there is one) to get the same type of encoding again. 
This is approximate ... Inherited from ImageDecoder. 

Get the horizontal dpi for the first frame. Inherited from ImageDecoderlntemal. 
Get the vertical dpi for the first frame. Inherited from ImageDecoderinternai. 
If there is an embedded color profile, return it. Otherwise, return null. This 
method does NOT create a color profile for images that don't already have 
one. Inherited from ImageDecoder. 

If there is an embedded thumbnail for the first frame, return it. Otherwise, 
return null. This method does NOT create a thumbnail for images that don't 
already have one. Inherited from ImageDecoderinternai. 
Get the pixel format for the first frame. Inherited from ImageDecoderlntemal. 

Get the height of the image in measure units (96ths of an inch). Inherited from 
ImageDecoder. 

The info that identifies this codec (including any associated encoder). 

A value indicating whether access to the ICollection is synchronized (thread- 
safe). Inherited from ImageDecoderlntemal. 

Indexer for returning a specific frame of the image (at full size). The index 
must be in the range: (NumFrames > index >= 0) Inherited from 
ImageDecoderinternai. 

Provides read-only access to this image's metadata. Inherited from 
jmageDecoderlnternal. 

Get the pixel Height for the first frame. Inherited from ImageDecoderlntemal. 
Get the pixel width for the first frame. Inherited from ImageDecoderinternai. 
Gets an object that can be used to synchronize access to the 
ICollection. Inherited from ImageDecoderinternai. 

Get the width of the image in measure units (96ths of an inch). Inherited from 
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ImageDecoder. 



ImageDec derGif Class 

Definition: The built-in Microsoft GIF Decoder. 



Method 



CopyTo 



Equals 
Finalize 

GetEnumerator 
GetFrame 

GetFrame 

GetHashCode 
GetType 

lEnumerable. GetEnumerator 
ImageDecoderGif 

Initialize 

MemberwiseClone 
op_Explicit 

ReferenceEquals 

ToString 



Description 

Copies the frames to an Array, starting at a particular Array 
index. Inherited from ImageDecoderlnternal. 

Determines whether two Object instances are equal. Inherited from 
Object. 

ImageDecoderlnternal Finalizer. Inherited from ImageDecoderlnternal. 
Returns an enumerator to iterate through the frames of the 
image, inherited from ImageDecoder. 

Return an image frame, cropped by the specified sourceRect. An empty 
rect (one wiih a width and/or height of 0), means to ignore the rect and get 
the entire frame. Inherited from ImageDecoder. 

Return an image frame, with all the specified cropping and sizing applied 
to it. An empty source rect (one with a width and/or height of 0), means to 
ignore the rect and get the entire frame. Inherited from 
ImageDecoderlnternal. 

Serves as a hash function for a particular type, suitable for use in hashing 
algorithms and data structures like a hash table. Inherited from Object. 
Gets the Type of the current instance. Inherited from Object. 
Inherited from ImageDecoder. 

If this decoder cannot handle the image stream, it will throw an exception. 
Initialize the codec. Instantiate the correct unmanaged codec by using the 
supplied Guid and then initialize it to the stream. Inherited from 
ImageDecoderlnternal. 

Creates a shallow copy of the current Object. Inherited from Object. 

Conversion from ImageDecoder to ImageSource by returning the first 
frame. Inherited from ImageDecoder. 

Determines whether the specified Object instances are the same 
instance. Inherited from Object. 

Returns a String that represents the current Object, inherited from Object. 



Property 



Count 



Description 

The number of image frames in this image. Inherited from 
ImageDecoderlnternal. 

Returns a codec-specific object that identifies the properties that were used to 
CustomEncoderProperties encode this ima 9e. These codec-specific properties can be passed back to the 

associated encoder (if there is one) to get the same type of encoding again. 
This is approximate ... Inherited from ImageDecoder. 

Get the horizontal dpi for the first frame. Inherited from ImageDecoderlnternal. 
Get the vertical dpi for the first frame. Inherited from ImageDecoderlnternal. 
If there is an embedded color profile, return it. Otherwise, return null. This 
method does NOT create a color profile for images that don't already have 
one. Inherited from ImageDecoder. 

If there is an embedded thumbnail for the first frame, return it. Otherwise, 



DpiX 
DpiY 

EmbeddedColorProfile 
EmbeddedThumbnail 
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Format 
Height 
Info 

IsSynchronized 
Item 

MetaData 

PixelHeight 
PixelWidth 

SyncRoot 
Width 



return null. This method does NOT create a thumbnail for images that don't 

already have one. Inherited from ImageDecoderlnternal. 

Get the pixel format for the first frame. Inherited from ImageDecoderlnternal. 

Get the height of the image in measure units (96ths of an inch). Inherited from 
ImageDecoder. 

The info that identifies this codec (including any associated encoder). 

A value indicating whether access to the ICollection is synchronized (thread- 
safe). Inherited from ImageDecoderlnternal. 

Indexer for returning a specific frame of the image (at full size). The index 
must be in the range: (NumFrames > index >= 0) Inherited from 
ImageDecoderlnternal. 

Provides read-only access to this image's metadata. Inherited from 
ImageDecoderlnternal. 

Get the pixel Height for the first frame. Inherited from ImageDecoderlnternal. 
Get the pixel width for the first frame. Inherited from ImageDecoderlnternal. 
Gets an object that can be used to synchronize access to the 
ICollection. Inherited from ImageDecoderlnternal. 

Get the width of the image in measure units (96ths of an inch). Inherited from 
ImageDecoder. 



ImageDecoderlcon Class 

Definition: The built-in Microsoft Icon Decoder. 



Method 



CopyTo 



Equals 
Finalize 

GetEnumerator 
GetFrame 

GetFrame 

GetHashCode 
GetType 

lEnumerable.GetEnumerator 
ImageDecoderlcon 

Initialize 

MemberwiseClone 
op_Explicit 



Description 

Copies the frames to an Array, starting at a particular Array 
index. Inherited from ImageDecoderlnternal. 

Determines whether two Object instances are equal. Inherited from 
Object. 

ImageDecoderlnternal Finalizer. Inherited from ImageDecoderlnternal. 
Returns an enumerator to iterate through the frames of the 
image, inherited from ImageDecoder. 

Return an image frame, cropped by the specified sourceRect. An empty 
rect (one with a width and/or height of 0), means to ignore the rect and get 
the entire frame. Inherited from ImageDecoder. 

Return an image frame, with all the specified cropping and sizing applied 
to it. An empty source rect (one with a width and/or height of 0), means to 
ignore the rect and get the entire frame. Inherited from 
I mageDecoderl nternal. 

Serves as a hash function for a particular type, suitable for use in hashing 
algorithms and data structures like a hash table. Inherited from Object. 
Gets the Type of the current instance. Inherited from Object. 
Inherited from ImageDecoder. 

If this decoder cannot handle the image stream, it will throw an exception. 
Initialize the codec. Instantiate the correct unmanaged codec by using the 
supplied Guid and then initialize it to the stream. Inherited from 
ImageDecoderlnternal. 

Creates a shallow copy of the current Object. Inherited from Object. 
Conversion from ImageDecoder to ImageSource by returning the first 
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ReferenceEquais 
ToString 



frame. Inherited from ImageDecoder. 

Determines whether the specified Object instances are the same 
instance. Inherited from Object. 

Returns a String that represents the current Object. Inherited from Object. 



Property 



Count 



CustomEncoderProperties 

DpiX 
DpiY 

EmbeddedColorProfile 

EmbeddedThumbnail 

Format 
Height 
Info 

IsSynchrcnized 
Item 

MetaData 

PixelHeight 
PixelWidth 

SyncRoot 
Width 



Description 

The number of image frames in this image. Inherited from 
ImageDecoderlnternai. 

Returns a codec-specific object that identifies the properties that were used to 
encode this image. These codec-specific properties can be passed back to the 
associated encoder (if there is one) to get the same type of encoding again. 
This is approximate ... Inherited from ImageDecoder. 
Get the horizontal dpi for the first frame. Inherited from ImageDecoderlnternai. 
Get the vertical dpi for the first frame. Inherited from ImageDecoderlnternai. 
If there is an embedded color profile, return it. Otherwise, return null. This 
method does NOT create a color profile for images that don't already have 
one. Inherited from ImageDecoder. 

If there is an embedded thumbnail for the first frame, return it. Otherwise, 
return null. This method does NOT create a thumbnail for images that don't 
already have one. inherited from ImageDecoderlnternai. 
Get the pixel format for the first frame. Inherited from ImageDecoderlnternai. 

Get the height of the image in measure units (96ths of an inch). Inherited from 
ImageDecoder. 

The info that identifies this codec (including any associated encoder). 
A value indicating whether access to the ICollection is synchronized (thread- 
safe). Inherited from ImageDecoderlnternai. 

Indexer for returning a specific frame of the image (at full size). The index 
must be in the range: (NumFrames > index >= 0) Inherited from 
ImageDecoderlnternai. 

Provides read-only access to this image's metadata. Inherited from 
ImageDecoderlnternai. 

Get the pixel Height for the first frame. Inherited from ImageDecoderlnternai. 
Get the pixel width for the first frame. Inherited from ImageDecoderlnternai. 
Gets an object that can be used to synchronize access to the 
ICollection. Inherited from ImageDecoderlnternai. 

Get the width of the image in measure units (96ths of an inch). Inherited from 
ImageDecoder. 



ImageDecoderlnternai Class 

Definition: For internal use only. 



Method 

CopyTo 

Equals 

Finaiize 

GetEnumerator 
GetFrame 



Description 

Copies the frames to an Array, starting at a particular Array index. 
Determines whether two Object instances are equal. Inherited from Object, 
imag Decoder! nternai Finaiizer. 

Returns an enumerator to iterate through the frames of the 
image. Inherited from ImageDecoder. 

Return an image frame, cropped by the specified sourceRect. An empty 
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GetFrame 

GetHashCode 
GetType 

lEnumerable.GetEnumerator 
imageDecoderlnternal 

Initialize 

MemberwiseClone 
op_Explicit 

ReferenceEquals 

ToString 



rect (one with a width and/or height of 0), means to ignore the rect and get 
the entire frame. Inherited from ImageDecoder. 

Return an image frame, with all the specified cropping and sizing applied 
to it. An empty source rect (one with a width and/or height of 0). means to 
ignore the rect and get the entire frame. 

Serves as a hash function for a particular type, suitable for use in hashing 
algorithms and data structures like a hash table. Inherited from Object. 
Gets the Type of the current instance. Inherited from Object. 
Inherited from ImageDecoder. 

Initialize the codec. Instantiate the correct unmanaged codec by using the 

supplied Guid and then initialize it to the stream. 

Creates a shallow copy of the current Object. Inherited from Object. 

Conversion from ImageDecoder to ImageSource by returning the first 
frame. Inherited from ImageDecoder. 

Determines whether the specified Object instances are the same 
instance. Inherited from Object. 

Returns a String that represents the current Object. Inherited from Object. 



Property 



Count 



CustomEncoderProperties 

DpiX 
DpiY 

EmbeddedColorProfile 



EmbeddedThumbnail 

Format 
Height 

Info 

IsSynchronized 
Item 

MetaData 
PixelHeight 
PixelWidth 
SyncRoot 

Width 



Description 

The number of image frames in this image. 

Returns a codec-specific object that identifies the properties that were used to 
encode this image. These codec-specific properties can be passed back to the 
associated encoder (if there is one) to get the same type of encoding again. 
This is approximate ... Inherited from ImageDecoder. 
Get the horizontal dpi for the first frame. 
Get the vertical dpi for the first frame. 

If there is an embedded color profile, return it. Otherwise, return null. This 
method does NOT create a color profile for images that don't already have 
one. Inherited from ImageDecoder. 

If there is an embedded thumbnail for the first frame, return it. Otherwise, 
return null. This method does NOT create a thumbnail for images that don't 
already have one. 

Get the pixel format for the first frame. 

Get the height of the image in measure units (96ths of an inch). Inherited from 
ImageDecoder. 

The info that identifies this codec (including any associated encoder). Inherited 
from ImageDecoder. 

A value indicating whether access to the ICollection is synchronized (thread- 
safe). 

Indexer for returning a specific frame of the image (at full size). The index 
must be in the range: (NumFrames > index >= 0) 
Provides read-only access to this image's metadata. 
Get the pixel Height for the first frame. 
Get the pixel width for the first frame. 

Gets an object that can be used to synchronize access to the ICollection. 

Get the width of the image in measure units (96ths of an inch). Inherited from 
ImageDecoder. 
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ImageDecoderJpeg Class 

Definition: The built-in Microsoft Jpeg Decoder. 



Method 

CopyTo 
Finalize 

GetEnumerator 



GetFrame 



GetFrame 



GetHashCode 



Description 



Copies the frames to an Array, starting at a particular Array 
index. Inherited from ImageDecoderlnternal. 



Determ^ 



GetType 

lEnumerable.GetEnumerator 
ImageDecoderJpeg 

Initialize 

MemberwiseClone 
op_Explicit 

ReferenceEquals 

ToString 



lines whether two Object instances are equal. Inherited from Object. 
ImageDecoderlnternal Finalizer. Inherited from ImageDecoderlnternal. 
Returns an enumerator to iterate through the frames of the 
image. Inherited from ImageDecoder. 

Return an image frame, cropped by the specified sourceRect. An empty 

rect (one with a width and/or height of 0), means to ignore the rect and get 

the entire frame, inherited from imageDecoder. 

Return an image frame, with all the specified cropping and sizing applied 

to it. An empty source rect (one with a width and/or height of 0), means to 

ignore the rect and get the entire frame. Inherited from 

irnageDecoderinlernai. 

Serves as a hash function for a particular type, suitable for use in hashing 
algorithms and data structures iike a hash tabie. inherited from Object. 
Gets the Type of the current instance. Inherited from Object. 
Inherited from ImageDecoder. 

If this decoder cannot handle the image stream, it will throw an exception. 
Initialize the codec. Instantiate the correct unmanaged codec by using the 
supplied Guid and then initialize it to the stream. Inherited from 
ImageDecoderlnternal. 

Creates a shallow copy of the current Object. Inherited from Object. 
Conversion from ImageDecoder to ImageSource by returning the first 
frame. Inherited from ImageDecoder. 

Determines whether the specified Object instances are the same 
instance. Inherited from Object. 

Returns a String that represents the current Object. Inherited from Object. 



Property Description 

Count The number °f image frames in this image. Inherited from 

ImageDecoderlnternal. 

Returns a codec-specific object that identifies the properties that were used to 
CustomEncoderProDerties encode this ima 9 e The se codec-specific properties can be passed back to the 

associated encoder (if there is one) to get the same type of encoding again. 



DpiX 
DpiY 

EmbeddedColorProfile 



EmbeddedThumbnail 



This is approximate ... Inherited from ImageDecoder. 
Get the horizontal dpi for the first frame. Inherited from ImageDecoderlnternal. 
Get the vertical dpi for the first frame. Inherited from ImageDecoderlnternal. 
If there is an embedded color profile, return it. Otherwise, return null. This 
method does NOT create a color profile for images that don't already have 
one. inherited from imageDecoder. 

If there is an embedded thumbnail for the first frame, return it. Otherwise, 
return null. This method does NOT create a thumbnail for images that don't 
already have one. Inherited from ImageDecoderlnternal. 
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Format 



Height 



Info 

IsSynchronized 
Item 

MetaData 

PixelHeight 
PixelWidth 

SyncRoot 
Width 



Get the pixel format for the first frame. Inherited from ImageDecoderlntemal. 

Get the height of the image in measure units (96ths of an inch). Inherited from 
ImageDecoder. 

The info that identifies this codec (including any associated encoder). 
A value indicating whether access to the ICollection is synchronized (thread- 
safe). Inherited from ImageDecoderlntemal. 

Indexer for returning a specific frame of the image (at full size). The index 
must be in the range: (NumFrames > Index >= m inhRritRd from 
ImageDecoderlntemal. 

Provides read-only access to this image's metadata. Inherited from 
ImageDecoderlntemal. 

Get the pixel Height for the first frame. Inherited from IrnageDeccderlnterna!. 
Get the pixel width for the first frame. Inherited from ImageDecoderlntemal. 
Gets an object that can be used to synchronize access to the 
ICollection. Inherited from ImageDecoderlntemal. 

Get the width of the image in measure units (96ths of an inch). Inherited from 
ImageDecoder. 



ImageDecoderPng Class 

Definition: The built-in Microsoft PNG Decoder. 



Method 

CopyTo 

Equals 

Finalize 

GetEnumerator 
GeiFrame 

GetFrame 

GetHashCode 
GetType 

lEnumerable.GetEnumerator 
ImageDecoderPng 

Initialize 

MemberwiseClone 
op_Explicit 
R ef ere n ce Ecj ua I s 



Description 

Copies the frames to an Array, starting at a particular Arra" 
index. Inherited from ImageDecoderlntemal.'' 
Determi 
Object. 



whether two Object instances are equal. Inherited frc 



l...ageDecoderlnternai Finalizer. Inherited from i'mageDecoderlnternai. 
Returns an enumerator to iterate through the frames of the 
image, inherited from imageDecoder. 

Return an image frame, cropped by the specified sourceRect. An empty 
rect (one with a width and/or height of 0), means to ignore the rect and get 
the entire frame. Inherited from ImageDecoder. 

Return an image frame, with all the specified cropping and sizing applied 
to it. An empty source rect (one with a width and/or height of 0), means to 

ignore the rect and get the entire frame, inherited from 
ImageDecoderlntemal. 

Serves as a hash function for a particular type, suitable for use in hashing 
algorithms and data structures like a hash table. Inherited from Object. 
Gets the Type of the current instance. Inherited from Object. 
Inherited from ImageDecoder. 

If this decoder cannot handle the image stream, it will throw an exception. 
Initialize the codec Instantiate the correct unmanaged codec hv using the 
supplied Guid and then initialize it to the stream. Inherited from' 
ImageDecoderlntemal. 

Creates a shallow copy of the current Object. Inherited from Object. 
Conversion from ImageDecoder to ImageSource by returning the first 
frame. Inherited from ImageDecoder. 

Determines whether the specified Object instances are the same 
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ToString 



Property 



Count 



CustomEncoderProperties 

DpiX 
DpiY 

EmbeddedColorProfile 

EmbeddedThumbnail 

Format 

Height 
Info 

IsSynchronized 
Item 

MetaData 

PixelHeight 
PixelWidth 

SyncRoot 
Width 



instance. Inherited from Object. 

Returns a String that represents the current Object. Inherited from Object 

Description 

The number of image frames in this image. Inherited from 
ImageDecoderlnternal. 

Returns a codec-specific object that identifies the properties that were used to 
encode this image. These codec-specific properties can be passed back to the 
associated encoder (if there is one) to get the same type of encoding again. 
This is approximate ... Inherited from ImageDecoder. 
Get the horizontal dpi for the first frame. Inherited from ImageDecoderlnternal. 
Get the vertical dpi for the first frame. Inherited from ImageDecoderlnternal. 
If there is an embedded color profile, return it. Otherwise, return null. This 
method does NOT create a color profile for images that don't already have 
one. inherited from imageDecoder. 

If there is an embedded thumbnail for the first frame, return it. Otherwise, 
return null. This method does NOT create a thumbnail for images that don't 
already have one. Inherited from ImageDecoderlnternal. 
Get the pixel format for the first frame. Inherited from ImageDecoderlnternal. 

Get the height of the image in measure units (96ths of an inch). Inherited from 
ImageDecoder. 

The info that identifies this codec (including any associated encoder). 
A value indicating whether access to the ICollection is synchronized (thread- 
safe). Inherited from ImageDecoderlnternal. 

Indexer for returning a specific frame of the image (at full size). The index 
must be in the range: (NumFrames > index >= 0) Inherited from 
ImageDecoderlnternal. 

Provides read-only access to this image's metadata. Inherited from 
ImageDecoderlnternal. 

Get the pixel Height for the first frame. Inherited from ImageDecoderlnternal. 
Get the pixel width for the first frame. Inherited from ImageDecoderlnternal. 
Gets an object that can be used to synchronize access to the 
ICollection. Inherited from ImageDecoderlnternal. 

Get the width of the image in measure units (96ths of an inch). Inherited from 
ImageDecoder. 



ImageDecoderTiff Class 

Definition: The built-in Microsoft Tiff Decoder. 



Method 



CopyTo 

Equals 
Finalize 

GetEnumerator 
GetFrame 



Description 

Copies the frames to an Array, starting at a particular Array 
index. Inherited from ImageDecoderlnternal. 

Determines whether two Object instances are equal. Inherited from 
Object. 

ImageDecoderlnternal Finalizer. Inherited from ImageDecoderlriternal. 
Returns an enumerator to iterate through the frames of the 

image, inherited from imageDecoder. 

Return an image frame, cropped by the specified sourceRect An empty 
rect (one with a width and/or height of 0), means to ignore the rect and get 
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GetFrame 



GeiKashCode 
GetType 

lEnumerable.GetEnumerator 
i ri lageDecodei Tiff 

initialize 

MemberwiseClone 
cp_Exp!icit 



I uou my 



the entire frame. Inherited from ImageDecoder. 

Return an image frame, with a!! the specified cropping and sizing applied 

to it. An empty source rect (one with a width and/or height of O^mea'ns to 

ignore the rect and get the entire frame. Inherited from 

ImageDecoderlnternal. 

Serves as a hash function for a particular type, suitable for use in hashing 
algorithms and data structures like a hash table. Inherited from Object. 
Gets the Type of the current instance. Inherited from Object. 
Inherited from ImageDecoder. 

if this decoder cannot handle ihe image Stream, ii wiii throw an exception. 
Initialize the codec. Instantiate the correct unmanaged codec by using the 
supplied Guid and then initialize it to the stream, inherited from 
ImageDecoderlnternal. 

Creates a shallow copy of the current Object. Inherited from Object. 

Conversion from ImageDecoder to ImageSource by returning the first 
frame. Inherited from ImageDecoder. 

Determines whether the specified Object instances are the same 
instance. Inherited from Object. 

Returns a String that represents the current Object. Inherited from Object. 



Pmnorhr 



Count 



CustomEncoderProperties 

DpiX 
DpiY 

EmbeddedColorProfile 

EmbeddedThumbnail 

Format 
Height 
Info 



Description 

The number of image frames in this image. Inherited from 
ImagsDeccderlr.tema!. 

Returns a codec-specific object that identifies the properties that were used to 
encode this image. These codec-specific properties can be passed back to the 
associated encoder (if there is one) to get the same type of encoding again. 
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Item 

MetaData 

PixelHeight 

PixelWidth 

SyncRoot 



Get the horizontal dpi for the first frame. Inherited from ImageDecoderlnternal. 
Get the vertical dpi for the first frame, inherited from imageDecoderinternai. 
If there is an embedded color profile, return it. Otherwise, return null. This 
method does NOT create a color profile for images that don't already have 
one. Inherited from ImageDecoder. 

If there is an embedded thumbnail for the first frame, return it. Otherwise, 
return null. This method does NOT create a thumbnail for images that don't 
already have one. inherited from imageDecoderinternai. 
Get the pixel format for the first frame. Inherited from ImageDecoderlnternal. 

Get the height of the image in measure units (96ths of an inch). Inherited from 
ImageDecoder. 

The info that identifies this codec (including any associated encoder). 
A value indicating whether access to the ICollection is synchronized (thread- 
safe). Inherited from ImageDecoderlnternal. 

Indexer for returning a specific frame of the image (at full size). The index 
must be in the range: (NumFrames > index >= 0) Inherited from 
ImageDecoderlnternal. 

Provides read-only access to this image's metadata. Inherited from 
ImageDecoderlnternal. 

Get the pixel Height for the first frame. Inherited from ImageDecoderlnternal. 
Get the pixel width for the first frame. Inherited from ImageDecoderlnternal. 
Gets an object that can be used to synchronize access to the 
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ICollection. Inherited from ImageDecoderlnternal. 

Get the width of the image in measure units (96ths of an inch). Inherited from 
ImageDecoder. 



ImageEffect Class 

Definition: The ImageEffect class is the base class for all imaging effects (blur, grayscale, etc) It's 
possible for an effect to not have any inputs but an effect must aiways have at ieast one output. The 
default implementations of things assume this. If a derived effect is going to play with Output/Outputs be 
sure thai at least one is there. 



Method 



uioneuore 



uioneuown i oUnchangeabie 
Copy 



Description 

Returns a modifiable shallow or deep clone of the current object. This 
abstract method must be impiemented by ciasses that derive from 
Changeable. Inherited from Changeable. 

Returns an immutable copy of the specified object. Inherited from 
Changeable. 



Copy 



ImageSource abstract method implementation PixelOffset actually 
doesn't do anything, if you don't want to start at (0,0) in the input, then 
have your sourceRect start at the point you want. 

Returns a modifiable copy of the current object. The copy's 
IsChangeable property is true and its StatusOfNextUse is 
Unchangeable, inheriied from Changeabie. 

Accesses the specified Changeable data member, processes it, and 
returns a reference to the member. This reference should then be 
EmbeddedChangeableReader reassigned to the original member variable. Classes that derive from 

Changeabie caii this method on data members before they can be 
retrieved through property calls. Inherited from Changeable. 
Processes a modified Changeabie data member and returns a 
reference to the processed object. Inherited from Changeable. 

Determines whether two Object instances are equal, inherited from 
Object. 

Allows an Object to attempt to free resources and perform other cleanup 
operations before the Object is reclaimed by garbage 
collection, inherited from Object. 

Horizontal DPI of the image. 

Vertical DPI of the image. 



EmbeddedChangeableWriter 
Equals 

Finalize 



GetDpiX 
GetDpiY 
GetFormat 



GetHashCode 

Get!ntema!BitmapSource 

GetOutput 

GetPaietie 

GetPixelHeight 

GetPixelWidth 

GetScaleX 



Serves as a hash function for a particular type, suitable for use in 
hashing algorithms and data structures like a hash table. Inherited from 
Object. 

ImageSource abstract method implementation 

Get a paiette for a particular output 
Height, in pixels, of the image. 
Width, in pixels, of the image. 

These values contain the horizontal and vertical scale applied to this 
source. There are occasions when an effect needs to operate at a 
different resolution or a different coordinate space than the current, 
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GetScaleY 
GetType 



imagetffect 



MakeUnchangeable 

MakeUnchangeableCore 
MemberwiseClone 

ModifyHandlerlfChangeable 
OnChanged 

PropagateEventHandler 

ReferenceEquals 
ToString 

ValidateObjectState 
WritePostscript 

WritePreamble 



logical coordinate space. Thus, these properties enable the consumer to 
map between local space and ImageEffectSource space. 

Gets the Type of the current instance. Inherited from Object. 
This constructor allows a derived class to specify the number of inputs 
and outputs for this offset, and this class wi!! then handle the input and 
output arrays, inlcuding validation of indicies. This defaults to 1 and 1. If 
the effect wishes to have a variable number of inputs or outputs, it can 
pass -1 for either (or both) counts, and the input and output collections 
will allow this. Finally, these methods are all virtual, so derived classes 
may choose not to delegate back to the base class, in which case no 
extra cost is incurred. 

Makes an object immutable; after this method is called on a 
Changeable, its IsChangeable property is false. Inherited from 
Changeable. 

Makes a Changeable object immutable. Inherited from Changeable. 
Creates a shallow copy of the current Object. Inherited from Object. 
Adds or removes a Changed event handler to or from the specified 
Changeable object, if the object is currently modifiable. If the specified 
object is not modifiable — if its IsChangeable property is false — this 
method has no effect. Inherited from Changeable. 

Called when the current object is modified. Classes that derive from 
Changed should call this method after they have been 
modified. Inherited from Changeable. 

Shares a Changed event handler with the current object's data 
members or removes it. Inherited from Changeable. 
Ensures that simple (non-Changeable) members are being accessed 
from a valid US context. This method should be called before any simple 
members are accessed. Inherited from Changeable. 

Determines whether the specified Object instances are the same 
instance. Inherited from Object. 

Returns a Siring that represents the current Object, inherited from 
Object. 

Verifies that the current object has a vaiid state, if the object is in an 
invalid state, this method throws an exception. Inherited from 
Changeable. 

Causes the current object to validate itself and then invokes the 
OnChanged method. Inherited from Changeable. 

Ensures that simple (non-Changeable) members are being accessed 
from a vaiid user interface (Ui) context. This method shouid be caiied 
before any simple members are set. Inherited from Changeable. 



Property Description 

Used in conjunction with the ChangeableUsageOverride type sent in 
AllowChanaeableReferenceOverride as a P aram eter to ChangeableHelper.UseChangeable, to help 

determine when a uhangeabie being put into :: use :: shouid be 
promoted to "ChangeableReference". Inherited from Changeable. 

CanMakeUnchanaeable True if this Chan 9 eab le can be made unchangeable. Inherited from 

y Changeable. 

Input This is the first input, and is an alias for lnputs[0] Perfomance 
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Inputs 

IsChangeable 

Output 
Outputs 

StatusOfNextUse 
UlContext 



Warning: If the input of the effect IS NOT in a format that the effect 
supports the effect will convert the input to a workable format for 
you. 

This is the collection of inputs 

Gets a Boolean that indicates whether the object is currently 
modifiable. Inherited from Changeable. 

This is the first output, and is an alias for OutputsfO] 

This is the collection of outputs 

Gets or sets a UseStatus enumeration that specifies how the 
Changeable object behaves when it is "used." A Changeable object 
is considered used in the foiiowing situations: the object is set into a 
Property System property, the object is used as a sub-object in a 
complex Changeable object, or the object is used in a 
DrawingContext command. Inherited from Changeable. 
Gets ihe UiContext of the current object. The UiConiext is used for 
maintaining thread safety. Inherited from Changeable. 



ImageEffectBlur Class 

Definition: Gaussian blur effect. It js a single input, single output effect. Warning: If the effect is being 
scaied (i.e. input.scaieX or input. scaieY isn ; t i) and Expand is true, then its possible for the output 
dimensions to be larger or smaller that PixelWidth and PixelHeight. Adjust the pixel buffer fed to copy to 



dVOid problems 



Method 

CloneCore 

CloneDownToUnchangeable 
Copy 

Copy 

EmbeddedChangeableReader 

EmbsddsdChangeableWriter 
Equals 

Finalize 

GetDpiX 
GetDpiY 
GetFormat 

GetHashCode 



uescriptioii 

Required by changeable? 

Returns an immutable copy of the specified object. Inherited from 
Changeable. 

This applies the effect and places the result in "pixels" 
Returns a modifiable copy of the current object. The copy's 
IsChangeable property is true and its StatusOfNextUse is 
Unchangeable. Inherited from Changeable. 

Accesses the specified Changeable data member, processes it, and 
returns a reference to the member. This reference should then be 
reassigned to the original member variable. Classes that derive from 
Changeable call this method on data members before they can be 
retrieved through property calls. Inherited from Changeable. 
Processes a modified Changeable data member and returns a 
reference to the processed object. Inherited from Changeable. 

Determines whether two Object instances are equal. Inherited from 
Object. 

Allows an Object to attempt to free resources and perform other cleanup 
operations before the Object is reclaimed by garbage 
collection. Inherited from Object. 

Horizontal DPI of the image. Inherited from ImageEffect. 

Vertical DP! of the image. Inherited from ImageEffect. 

Inherited from ImageEffect. 

Serves as a hash function for a particular type, suitable for use in 
hashing algorithms and data structures like a hash table. Inherited from 
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GetlnternalBitmapSource 

GetOutput 

GetPalette 

GelPixeiHeighi 

GetPixelWidth 



GetScaleX 



GetScaieY 

GetType 

ImageEffectBlur 

MakeUnchangeable 

MakeUnchangeableCore 
MemberwiseClone 

ModifyHandlerlfChangeable 



OnHhsannoH 



PropagateEventHandler 

ReadPreamble 

ReferenceEquals 
ToString 



vauaaieuDjeCioiaie 
WritePostscript 

WritePreamble 



Required by ImageEffect 

Inherited from ImageEffect. 

Get a palette for a particular output Inherited from ImageEffect. 
Height, in pixels, of the image, inherited from imageEifecL 
Width, in pixels, of the image. Inherited from ImageEffect. 
These values contain the horizontal and vertical scale applied to this 
source. There are occasions when an effect needs to operate at a 
different resolution or a different coordinate space than the current, 
logical coordinate space. Thus, these properties enable the consumer to 
map beiween iocai Space and iVnageEffeciSourCe space, inherited from 
ImageEffect. 

inherited from ImageEffect. 

Gets the Type of the current instance. Inherited from Object. 
Default Constructor 

Makes an object immutable; after this method is called on a 
Changeable, its IsChangeable property is false. Inherited from 
Changeable. 

Makes a Changeable object immutable. Inherited from Changeable. 
Creates a shallow copy of the current Object. Inherited from Object. 
Adds or removes a Changed event handler to or from the specified 
Changeable object, if the object is currently modifiable. !f the specified 
object is not modifiable— if its IsChangeable property is false— this 
method has no effect. Inherited from Changeable. 
Called when the current object is modified. Classes that derive from 
Changed should call this method after they have been 
modified. Inherited from Changeable. 

Shares a Changed event handler with the current object's data 
members or removes it. Inherited from Changeable. 
Ensures that simple (non-Changeable) members are being accessed 
from a valid Ul context. This method should be called before any simple 
members are accessed. Inherited from Changeable. 

Determines whether the specified Object instances are the same 

instance. Inherited from Object. 

Returns a String that represents the current Object. Inherited from 
Object. 

Verifies that the current object has a valid state. If the object is in an 
invaiid state, this method throws an exception, inherited from 
Changeable. 

Causes the current object to validate itseif and then invokes the 
OnChanged method. Inherited from Changeable. 
Ensures that simple (non-Changeable) members are being accessed 
from a valid user interface (Ul) context. This method should be called 
before any simpie members are set inherited from Changeable. 



Property Description 

Used in conjunction with the ChangeableUsageOverride type sent in 
AllowChangeableReferenceOverride as a P arameter to ChangeableHelper.UseChangeable, to help 

determine when a Changeable being put into "use" should be 
promoted to :j ChangeabieReference :: . inherited from Changeable. 
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CanMakeUnchangeable 
Expand 

Input 
Inputs 

IsChangeable 

Output 

Outputs 
Radius 

StatusOfNextUse 
uiConiext 



True if this Changeable can be made unchangeable. Inherited from 
Changeable. 

If true, the blur will spread out and create a larger image. If false, the 
blur will be contained. 

This is the first input, and is an alias for lnputs[0] Perfomance 
Warning: If the input of the effect IS NOT in a format that the effect 
supports the effect wiii convert the input to a workabie format for 
you. Inherited from ImageEffect. 

This is the collection of inputs Inherited from ImageEffect. 
Gets a Boolean that indicates whether the object is currently 
modifiable. Inherited from Changeable. 

This is the first output, and is an alias for Outputs[0] Inherited from 
ImageEffect. 

This is the collection of outputs Inherited from ImageEffect. 
Radius of the blur kernel. 

Gets or sets a UseStatus enumeration that specifies how the 
Changeable object behaves when it is "used." A Changeable object 
is considered used in the following situations: the object is set into a 
Property System property, the object is used as a sub-object in a 
complex Changeable object or the object is used in a 
DrawingContext command. Inherited from Changeable. 
Gets the UlContext of the current object. The UlContext is used for 
maintaining thread safety. Inherited from Changeable. 



ImageEffectFlipRotate Class 

Definition: This effect can flip an image in X or Y and rotate by multiples of 90 deg. 



Method 

CloneCore 

CloneDownToUnchangeable 
Copy 

Copy 



EmbeddedChangeableReader 

EmbeddedChangeableWriter 
Equals 

Finalize 

GetDpiX 
GetDpiY 



Description 

Required by changeable? 

Returns an immutable copy of the specified object. Inherited from 

Changeable. 

This applies the effect and places the result in "pixels" 
Returns a modifiable copy of the current object. The copy's 
IsChangeable property is true and its StatusOfNextUse is 

Unchangeable, inherited from Changeable. 

Accesses the specified Changeable data member, processes it, and 
returns a reference to the member, i his reference shouid then be 
reassigned to the original member variable. Classes that derive from 
Changeable call this method on data members before they can be 
retrieved through property calls. Inherited from Changeable. 
Processes a modified Changeable data member and returns a 
reference to the processed object. Inherited from Changeable. 

Determines whether two Object instances are equai. inherited from 
Object. 

Allows an Object to attempt to free resources and perform other cleanup 
operations before the Object is reclaimed by garbage 
collection, inherited from Object. 

Horizontal DPI of the image. Inherited from ImageEffect. 
Vertical DPI of the image. Inherited from ImageEffect. 
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GetFormat 

GetHashCode 

GetlnternalBitmapSource 

rir>*r>i if rM if 

GetPalette 

GetPixelHeight 

GetPixelWidth 



GetScaleX 



GetScaleY 
GetType 

ImageEffectFlipRotate 
MakeUnchangeable 

MakeUnchangeableCore 

MemberwiseCione 

ModifyHandlerlfChangeable 



uiiuiianycu 



PropagateEventHandler 

ReadPreamble 

ReferenceEquals 
ToStrina 

ValidateObjectState 
WritePostscript 

WritePreamble 

Property 



Inherited from ImageEffect. 

Serves as a hash function for a particular type, suitable for use in 
hashing algorithms and data structures like a hash table. Inherited from 
Object. 

Required by ImageEffect 

Inherited from ImageEffect. 

Get a palette for a particular output Inherited from ImageEffect. 
Height, in pixels, of the image. Inherited from ImageEffect. 
Width, in pixels, of the image. Inherited from ImageEffect 
These values contain the horizontal and vertical scale applied to this 
source. There are occasions when an effect needs to operate at a 
different resolution or a different coordinate space than the current, 
logical coordinate space. Thus, these properties enable the consumer to 
map between local space and ImageEffectSource space. Inherited from 
ImageEffect. 

Inherited from ImageEffect. 

Gets the Type of the current instance. Inherited from Object. 
FlipRotate constructor. It is a single input, single output effect. 
Makes an object immutable; after this method is called on a 
Changeable, its IsChangeable property is false. Inherited from 
Changeable. 

Makes a Changeable object immutable. Inherited from Changeable. 
Creates a shallow copy of the current Object, inherited from Object. 
Adds or removes a Changed event handler to or from the specified 
Changeable object, if the object is currently modifiable, if the specified 
object is not modifiable— if its IsChangeable property is false— this 
method has no effect. Inherited from Changeable. 
Called when the current object is modified. Classes that derive from 
Changed should call this method after they have been 
modified. Inherited from Changeable. 

Shares a Changed event handier wiih ihe current object's data 
members or removes it. Inherited from Changeable. 
Ensures that simpie (non-Changeabie) members are being accessed 
from a valid Ul context. This method should be called before any simple 
members are accessed. Inherited from Changeable. 

Determines whether the specified Object instances are the same 
instance, inheriied from Object. 

Returns a String that represents the current Object. Inherited from 
Object. 

Verifies that the current object has a valid state. If the object is in an 
invalid state, this method throws an exception. Inherited from 
Changeable. 

Causes the current object to validate itself and then invokes the 
OnChanged method. Inherited from Changeable. 
Ensures that simple (non-Changeable) members are being accessed 
from a valid user interface (Ul) context. This method should be called 
before any simple members are set. Inherited from Changeable. 

Description 
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Used in conjunction with the ChangeableUsageOverride type sent in 

AllowChangeableReferenceOverride as a P arameter to ChangeableHelper.UseChangeable, to help 

determine when a Changeable being put into "use" should be 
promoted to "ChangeableReference". Inherited from Changeable. 

True if this Changeable can be made unchangeable. Inherited from 
Changeable. 

Flip the image over the horizontal axis 
Flip the image over the vertical axis 

This is the first input, and is an alias for InputsfO] Perfomance 
Warning: If the input of the effect IS NOT in a format that the effect 
supports the effect wili convert the input to a workable format for 
you. Inherited from ImageEffect. 

This is the collection of inputs Inherited from ImageEffect. 
Gets a Boolean that indicates whether the object is currently 
modifiable. Inherited from Changeable. 

This is the first output, and is an alias for Outputs[0] Inherited from 
ImageEffect. 

This is the collection of outputs Inherited from ImageEffect. 
The number of degrees to rotate. This must be a multiple of 90 
degrees. A positive number rotates CW and a negative number 
rotates CCW. 

Gets or sets a UseStatus enumeration that specifies how the 
Changeable object behaves when it is "used." A Changeable object 
is considered used in the following situations: the object is set into a 
Property System property, the object is used as a sub-object in a 
complex Changeable object, or the object is used in a 
DrawingContext command. Inherited from Changeable. 
Gets the UlContext of the current object. The UlContext is used for 
maintaining thread safety. Inherited from Changeable. 



CanMakeUnchangeable 

FlipX 
FlipY 

Input 

Inputs 

IsChangeable 

Output 
Outputs 

Rotation 



StatusOfNextUse 



UlContext 



ImageEffectGammaCorrect Class 

Definition: This effect changes the gamma of an image. 

Method 



CloneCore 

CloneDownToUnchangeable 
Copy 

Copy 



Description 

Required by changeable? 

Returns an immutable copy of the specified object. Inherited from 
Changeable. 

This applies the effect and places the result in "pixels" 
Returns a modifiable copy of the current object. The copy's 
IsChangeable property is true and its StatusOfNextUse is 
Unchangeable. Inherited from Changeable. 
Accesses the specified Changeable data member, processes it, and 
returns a reference to the member. This reference should then be 
EmbeddedChangeableReader reassigned to the original member variable. Classes that derive from 

Changeable call this method on data members before they can be 
retrieved through property calls. Inherited from Changeable. 
Processes a modified Changeable data member and returns a 
reference to the processed object. Inherited from Changeable. 
Determines whether two Object instances are equai. inherited from 



EmbeddedChangeableWriter 
Equais 
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Finalize 



GetDpiX 
GetDpiY 
GetFormat 



GetHashCode 

GetlnternalBitmapSource 

GetOutput 

GetPalette 

GetPixelHeight 

GetPixeiWidth 



GetScaleX 



GetScaleY 
GetType 

ImageEffectGammaCorrect 

MakeUnchangeable 

MakeUnchangeableCore 
MemberwiseClone 

ModifyHandlerlfChangeable 



OnChanged 

PropagateEventHandler 

Read Preamble 

ReferenceEquais 
ToString 

ValidateObjectState 
WritePostscript 



Object. 

Allows an Object to attempt to free resources and perform other cleanup j 
operations before the Object is reclaimed by garbage 
collection. Inherited from Object. 

Horizontal DPI of the image. Inherited from ImageEffect. 

Vertical DPI of the image. Inherited from ImageEffect. 

Inherited from ImageEffect 

Serves as a hash function for a particular type, suitable for use in 
hashing algorithms and data structures like a hash table. Inherited from 

Object. 

Required by ImageEffect 
Inherited from ImageEffect. 

Get a palette for a particular output Inherited from ImageEffect. 
Height, in pixels, of the image. Inherited from ImageEffect. 
Width, in pixels, of the image. Inherited from ImageEffect. 
These values contain the horizontal and vertical scale applied to this 
source. There are occasions when an effect needs to operate at a 
different resolution or a different coordinate space than the current, 
logical coordinate space. Thus, these properties enable the consumer to 
map between local space and ImageEffectSource space. Inherited from 
ImageEffect. 

Inherited from ImageEffect. 

Gets the Type of the current instance. Inherited from Object. 
Gamma correction effect. It is a single input, single output effect. 
Makes an object immutable; after this method is called on a 
Changeable, its IsChangeable property is false. Inherited from 
Changeable. 

Makes a Changeable object immutable. Inherited from Changeable. 
Creates a shallow copy of the current Object. Inherited from Object. 
Adds or removes a Changed event handler to or from the specified 
Changeable object, if the object is currently modifiable. If the specified 
object is not modifiable — if its IsChangeable property is false — this 
method has no effect. Inherited from Changeable. 

Called when the current object is modified. Classes that derive from 
Changed should call this method after they have been 
modified. Inherited from Changeable. 

Shares a Changed event handler with the current object's data 
members or removes it. Inherited from Changeable. 
Ensures that simple (non-Changeable) members are being accessed 
from a valid Ul context. This method should be called before any simple 
members are accessed. Inherited from Changeable. 

Determines whether the specified Object instances are the same 
instance. Inherited from Object. 

Returns a String that represents the current Object. Inherited from 
Object. 

Verifies that the current object has a valid state. If the object is in an 
invalid state, this method throws an exception. Inherited from 
Changeable. 

Causes the current object to validate itself and then invokes the 
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WritePreamble 



OnChanged method. Inherited from Changeable. 
Ensures that simple (non-Changeable) members are being accessed 
from a valid user interface (Ul) context. This method should be called 
before any simple members are set. Inherited from Changeable. 



Property 

AllowChangeableReferenceOverride 

BlueGamma 

CanMakeUnchangeable 

GreenGamma 

Input 

Inputs 

IsChangeable 

Output 

Outputs 
RedGamma 

StatusOfNextUse 
UlContext 



Description 

Used in conjunction with the ChangeableUsageOverride type sent in 
as a parameter to ChangeableHelper.UseChangeable, to help 
determine when a Changeable being put into "use" should be 
promoted to "ChangeableReference". Inherited from Changeable. 
The correction for blue (1 .0 means no change) 

True if this Changeable can be made unchangeable. Inherited from 
Changeable. 

The correction for green (1.0 means no change) 

This is the first input, and is an alias for lnputs[0] Perfomance 
Warning: If the input of the effect IS NOT in a format that the effect 
supports the effect will convert the input to a workable format for 
you. inherited from ImageEffect. 

This is the collection of inputs Inherited from ImageEffect. 

Gets a Boolean that indicates whether the object is currently 
modifiable. Inherited from Changeable. 

This is the first output, and is an alias for OutputsfO] Inherited from 
ImageEffect. 

This is the collection of outputs Inherited from ImageEffect. 
The correction for red (1.0 means no change) 
Gets or sets a UseStatus enumeration that specifies how the 
Changeable object behaves when it is "used." A Changeable object 
is considered used in the following situations: the object is set into a 
Property System property, the object is used as a sub-object in a 
complex Changeable object, or the object is used in a 
DrawingContext command. Inherited from Changeable. 

Gets the UlContext of the current object. The UiContext is used for 
maintaining thread safety. Inherited from Changeable. 



ImageEffectGlow Class 

Definition: Performs a glow effect. It is a single input, single output effect. 



Method 

CloneCore 

CloneDownToUnchangeable 
Copy 

Copy 

EmbeddedChangeableReader 



Description 

Required by changeable? 

Returns an immutable copy of the specified object. Inherited from 
Changeable. 

This applies the effect and places the result in "pixels" 
Returns a modifiable copy of the current object. The copy's 
IsChangeable property is true and its StatusOfNextUse is 
Unchangeable. Inherited from Changeable. 

Accesses the specified Changeable data member, processes it, and 
returns a reference to the member. This reference should then be 
reassigned to the original member variable. Classes that derive from 
Changeable call this method on data members before they can be 



144 



EmbeddedChangeableWriter 
Equals 

Finalize 

GetDpiX 
GetDpiY 
GetFormat 

GetHashCode 

GetlnternalBitmapSource 

GetOutput 

GetPalette 

GetPixelHeight 

GetPixelWidth 

GetScaleX 



GetScaleY 
GetType 

ImageEffectGlow 

MakeUnchangeable 

MakeUnchangeableCore 
MemberwiseClone 

ModifyHandlerlfChangeable 



OnChanged 

PropagateEventHandler 

ReadPreamble 

ReferenceEquals 
ToString 



retrieved through property calls. Inherited from Changeable. 
Processes a modified Changeable data member and returns a 
reference to the processed object Inherited from Changeable. 

Determines whether two Object instances are equal. Inherited from 
Object. 

Allows an Object to attempt to free resources and perform other cleanup 
operations before the Object is reclaimed by garbage 
collection. Inherited from Object. 

Horizontal DPI of the image. Inherited from ImageEffect. 

Vertical DPI of the image, inherited from ImageEffect 

Inherited from ImageEffect. 

Serves as a hash function for a particular type, suitable for use in 
hashing algorithms and data structures like a hash table. Inherited from 

Object. 

Required by ImageEffect 
Inherited from ImageEffect. 

Get a palette for a particular output Inherited from ImageEffect. 
Height, in pixels, of the image. Inherited from ImageEffect. 
Width, in pixels, of the image. Inherited from ImageEffect 
These values contain the horizontal and vertical scale applied to this 
source, i here are occasions when an effect needs to operate at a 
different resolution or a different coordinate space than the current, 
logical coordinate space. Thus, these properties enable the consumer to 
map between local space and ImageEffectSource space. Inherited from 
ImageEffect. 

Inherited from ImageEffect. 

Gets the Type of the current instance, inherited from Object 
Default Constructor 

Makes an object immutable; after this method is called on a 
Changeable, its IsChangeable property is false. Inherited from 
Changeable. 

Makes a Changeable object immutable. Inherited from Changeable. 
Creates a shallow copy of the current Object. Inherited from Object. 
Adds or removes a Changed event handler to or from the specified 
Changeable object, if the object is currently modifiable. If the specified 
object is not modifiable — if its IsChangeable property is false — this 
method has no effect. Inherited from Changeable. 

Called when the current object is modified. Classes that derive from 
Changed should call this method after they have been 
modified. Inherited from Changeable. 

Shares a Changed event handler with the current object's data 
members or removes it. Inherited from Changeable. 
Ensures that simple (non-Changeable) members are being accessed 
from a valid Ul context. This method should be called before any simple 
members are accessed. Inherited from Changeable. 

Determines whether the specified Object instances are the same 
instance. Inherited from Object. 

Returns a String that represents the current Object. Inherited from 
Object 
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ValidateObjectState 
WritePostscript 

WritePreamble 

Property 



Verifies that the current object has a valid state. If the object is in an 
invalid state, this method throws an exception. Inherited from 
Changeable. 

Causes the current object to validate itself and then invokes the 
OnChanged method. Inherited from Changeable. 
Ensures that simple (non-Changeable) members are being accessed 
from a valid user interface (Ul) context. This method should be called 
before any simple members are set. Inherited from Changeable. 



Description 

Used in conjunction with the ChangeableUsageOverride type sent in 
AllowChangeableReferenceOverride as a P arameter t0 ChangeableHelper.UseChangeable, to help 

determine when a Changeable being put into "use" should be 
promoted to "ChangeableReference". Inherited from Changeable. 

The aspect ratio of the glow (i.e. it impacts how much it glows in one 
direction over another) 

True if this Changeable can be made unchangeable. Inherited from 

Changeable. 

If this is true, the source image is pasted on top of the glow. If this is 
false, all the effect does is return the glow. 
The inner of the two glow colors. 

This is the first input, and is an alias for lnputs[0] Perfomance 
Warning: If the input of the effect IS NOT in a format that the effect 
supports the effect will convert ihe input to a workable format for 
you. Inherited from ImageEffect. 

This is the collection of inputs Inherited from ImageEffect. 
The glow intensity. 

Gets a Boolean that indicates whether the object is currently 
modifiable. Inherited from Changeable. 
The outer of the two glow colors. 

This is the first output, and is an alias for Outputs[0] Inherited from 
ImageEffect. 

This is the collection of outputs Inherited from ImageEffect. 
Size of the glow. 

Gets or sets a UseStatus enumeration that specifies how the 
Changeable object behaves when it is "used." A Changeable object 
is considered used in the following situations: the object is set into a 
Property System property, the object is used as a sub-object in a 
complex Changeable object, or the object is used in a 
DrawingContext command. Inherited from Changeable. 
Gets the UlContext of the current object. The UlContext is used for 
maintaining thread safety. Inherited from Changeable. 



AspectRatio 

CanMakeUnchangeable 

Composite 
InnerColor 

Input 

inputs 
Intensity 

IsChangeable 

OuterColor 

Output 

Outputs 
Size 

StatusOfNextUse 
UlContext 



ImageEffectGrayscale Class 

Definition: Converts an image to grayscale. It is a single input, single output effect. 

Meth d Description 

CloneCore Required by changeable? 

CloneDownToUnchangeable Returns an immutable copy of the specified object. Inherited from 
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Copy 
Copy 

EmbeddedChangeableReader 

EmbeddedChangeableWriter 
Equals 

Finalize 

GetDpiX 
GetDpiY 
GetFormat 

GetHashCode 

GetlnternalBitmapSource 

GetOutput 

GetPalette 

GetPixelHeight 

GetPixelWidth 

GetScaleX 



GetScaleY 
GetType 

ImageEffectGrayscale 

MakeUnchangeable 

MakeUnchangeableCore 
MemberwiseClone 

ModifyHandierlfChangeable 



OnChanged 



Changeable. 

This applies the effect and places the result in "pixels" 
Returns a modifiable copy of the current object. The copy's 
IsChangeable property is true and its StatusOfNextUse is 
Unchangeable. Inherited from Changeable. 
Accesses the specified Changeable data member, processes it, and 
returns a reference to the member. This reference should then be 
reassigned to the original member variable. Classes that derive from 
Changeable call this method on data members before they can be 
retrieved through property calls. Inherited from Changeable. 
Processes a modified Changeable data member and returns a 
reference to the processed object. Inherited from Changeable. 

Determines whether two Object instances are equal. Inherited from 
Object. 

Allows an Object to attempt to free resources and perform other cleanup 
operations before the Object is reclaimed by garbage 
collection. Inherited from Object. 

Horizontal DPI of the image. Inherited from ImageEffect. 

Vertical DPI of the image. Inherited from ImageEffect. 

Inherited from ImageEffect. 

Serves as a hash function for a particular type, suitable for use in 
hashing algorithms and data structures like a hash table. Inherited from 
Object. 

Required by ImageEffect 
Inherited from ImageEffect. 

Get a palette for a particular output Inherited from ImageEffect. 
Height, in pixels, of the image. Inherited from ImageEffect. 
Width, in pixels, of the image. Inherited from ImageEffect. 
These values contain the horizontal and vertical scale applied to this 
source. There are occasions when an effect needs to operate at a 
different resolution or a different coordinate space than the current, 
logical coordinate space. Thus, these properties enable the consumer to 
map between local space and ImageEffectSource space. Inherited from 
ImageEffect. 

Inherited from ImageEffect 

Gets the Type of the current instance. Inherited from Object. 
Default Constructor 

Makes an object immutable; after this method is called on a 
Changeable, its IsChangeable property is false. Inherited from 
Changeable. 

Makes a Changeable object immutable. Inherited from Changeable. 
Creates a shallow copy of the current Object. Inherited from Object. 
Adds or removes a Changed event handler to or from the specified 
Changeable object, if the object is currently modifiable. If the specified 
object is not modifiable— if its IsChangeable property is false— this 
method has no effect. Inherited from Changeable. 
Called when the current object is modified. Classes that derive from 
Changed should call this method after they have been 
modified. Inherited from Changeable. 
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Shares a Changed event handler with the current object's data 

members or removes it. Inherited from Changeable. 

Ensures that simple (non-Changeable) members are being accessed 

from a valid Ul context. This method should be called before any simple 

members are accessed. Inherited from Changeable. 

Determines whether the specified Object instances are the same 

instance. Inherited from Object. 

Returns a String that represents the current Object. Inherited from 
Object. 

Verifies that the current object has a valid state. If the object is in an 
invalid state, this method throws an exception. Inherited from 
Changeable. 

Causes the current object to validate itself and then invokes the 
OnChanged method. Inherited from Changeable. 
Ensures that simple (non-Changeable) members are being accessed 
from a valid user interface (Ul) context. This method should be called 
before any simple members are set. Inherited from Changeable. 



Property Description 

Used in conjunction with the ChangeableUsageOverride type sent in 

AllowChangeableReferenceOverride as a P arameter to ChangeableHelper.UseChangeable, to help 

determine when a Changeable being put into "use" should be 
promoted to "ChangeableReference". Inherited from Changeable. 

True if this Changeable can be made unchangeable. Inherited from 
Changeable. 

This is the first input, and is an alias for lnputs[0] Perfomance 
Warning: If the input of the effect IS NOT in a format that the effect 
supports the effect will convert the input to a workable format for 
you. Inherited from ImageEffect. 

This is the collection of inputs inherited from imageEffect. 

Gets a Boolean that indicates whether the object is currently 
modifiable. Inherited from Changeable. 

This is the first output, and is an alias for Outputs[0] Inherited from 
ImageEffect. 

This is the collection of outputs Inherited from ImageEffect. 
Gets or sets a UseStatus enumeration that specifies how the 
Changeable object behaves when it is "used." A Changeable object 
is considered used in ihe following situations: the object is set into a 
Property System property, the object is used as a sub-object in a 
complex Changeable object, or the object is used in a 
DrawingContext command. Inherited from Changeable. 
Gets the UiContext of the current object. The UlContext is used for 
maintaining thread safety. Inherited from Changeable. 



CanMakeUnchangeable 

Input 
inputs 

IsChangeable 

Output 
Outputs 

StatusOfNextUse 
UlContext 



ImageEffectNegate Class 
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Definition: Negates an image. It is a single input, single output effect. 



Method 

CloneCore 

CloneDownToUnchangeable 
Copy 

Copy 

EmbeddedChangeableReader 

EmbeddedChangeableWriter 
Equals 

Finalize 

GetDpiX 
GetDpiY 
GetFormat 

GetHashCode 

GetlnternalBitmapSource 

GetOutput 

GetPalette 

GetPixelHeight 

GetPixeiWidth 

GetScaleX 



GetScaleY 
GetType 

ImageEffectNegate 

MakeUnchangeable 

MakeUnchangeableCore 
MemberwiseClone 

ModifyHandlerlfChangeable 



Description 

Required by changeable? 

Returns an immutable copy of the specified object. Inherited from 
Changeable. 

This applies the effect and places the result in "pixels" 
Returns a modifiable copy of the current object. The copy's 
IsChangeable property is true and its StatusOfNextUse is 
Unchangeable. Inherited from Changeable. 

Accesses the specified Changeable data member, processes it, and 
returns a reference to the member. This reference should then be 
reassigned to the original member variable. Classes that derive from 
Changeable call this method on data members before they can be 
retrieved through property calls. Inherited from Changeable. 

Processes a modified Changeable data member and returns a 
reference to the processed object. Inherited from Changeable. 

Determines whether two Object instances are equal. Inherited from 
Object. 

Allows an Object to attempt to free resources and perform other cleanup 
operations before the Object is reclaimed by garbage 
collection. Inherited from Object. 

Horizontal DPI of the image. Inherited from ImageEffect. 

Vertical DPI of the image, inherited from ImageEffect. 

Inherited from ImageEffect. 

Serves as a hash function for a particular type, suitable for use in 
hashing algorithms and data structures like a hash table. Inherited from 
Object. 

Required by ImageEffect 
Inherited from ImageEffect. 

Get a palette for a particular output Inherited from ImageEffect 
Height, in pixels, of the image. Inherited from ImageEffect. 
Width, in pixels, of the image, inherited from ImageEffect. 
These values contain the horizontal and vertical scale applied to this 
source. There are occasions when an effect needs to operate at a 
different resolution or a different coordinate space than the current, 
logical coordinate space. Thus, these properties enable the consumer to 
map between local space and ImageEffectSource space. Inherited from 
ImageEffect. 

Inherited from ImageEffect. 

Gets the Type of the current instance, inherited from Object. 
Default Constructor 

Makes an object immutable; after this method is called on a 
Changeable, its IsChangeable property is false. Inherited from 
Changeable. 

Makes a Changeable object immutable. Inherited from Changeable. 
Creates a shallow copy of the current Object. Inherited from Object. 
Adds or removes a Changed event handler to or from the specified 
Changeable object, if the object is currently modifiable. If the specified 
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ToString 
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object is not modifiable — if its IsChangeable property is false— this 
method has no effect. Inherited from Changeable. 

Called when the current object is modified. Classes that derive from 
Changed should call this method after they have been 
modified. Inherited from Changeable. 

Shares a Changed event handler with the current object's data 
members or removes it. Inherited from Changeable. 
Ensures that simple (non-Changeable) members are being accessed 
from a valid Ul context. This method should be called before any simple 
members are accessed. Inherited from Changeable. 

Determines whether the specified Object instances are the same 
instance. Inherited from Object. 

Returns a String that represents the current Object. Inherited from 

Object. 

Verifies that the current object has a valid state. If the object is in an 
invalid state, this method throws an exception. Inherited from 
Changeable. 

Causes the current object to validate itself and then invokes the 
OnChanged method. Inherited from Changeable. 
Ensures thai simple (non-Changeable) members are being accessed 
from a valid user interface (Ul) context. This method should be called 
before any simple members are set. Inherited from Changeable. 



Property 



j 



Description 

Used in conjunction with the ChangeableUsageOverride type sent in 
AllowChangeableReferenceOverride ! s a P^eter to ChangeableHelper.UseChangeable, to help 

determine when a Changeable being put into "use" should be 
promoted to "ChangeableReferenee". Inherited from Changeable. 

True if this Changeable can be made unchangeable. Inherited from 
Changeable. 

This is the first input, and is an alias for lnputs[0] Perfomance 
Warning: If the input of the effect IS NOT in a format that the effect 
supports the effect will convert the input to a workable format for 
you. Inherited from ImageEffect. 

This is the collection of inputs Inherited from ImageEffect. 

Gets a Boolean that indicates whether the object is currently 
modifiable. Inherited from Changeable. 

This is the first output, and is an alias for Outputs[0] Inherited from 
ImageEffect. 

This is the collection of outputs Inherited from ImageEffect. 
Gets or sets a UseStatus enumeration that specifies how the 
Changeable object behaves when it is "used." A Changeable object 
is considered used in the following situations: the object is set into a 
Property System property, the object is used as a sub-object in a 
complex Changeable object, or the object is used in a 
DrawingContext command. Inherited from Changeable. 
Gets the UlContext of the current object. The UlContext is used for 
maintaining thread safety. Inherited from Changeable. 



CanMakeUnchangeable 

Input 
Inputs 

IsChangeable 

Output 
Outputs 

StatusOfNextUse 
UlContext 



ImageEffectSharpen Class 
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Definition: Unsharp mask. It is a single input, single output effect. 



Method 

CloneCore 

CloneDownToUnchangeable 
Copy 

Copy 

EmbeddedChangeableReader 

EmbeddedChangeableWriter 
Equals 

Finalize 

GetDpiX 
GetDpiY 
GetFormat 

GetHashCode 

GetlnternalBitmapSource 

GetOutput 

GetPalette 

GetPixelHeight 

GetPixeiVVidth 

GetScaleX 



GetScaleY 
GetType 

I mageEffectSharpen 

MakeUnchangeable 

MakeUnchangeableCore 
MemberwiseClone 

ModifyHandlerlfChangeable 



Description 

Required by changeable? 

Returns an immutable copy of the specified object. Inherited from 
Changeable. 

This applies the effect and places the result in "pixels' 1 
Returns a modifiable copy of the current object. The copy's 
IsChangeable property is true and its StatusOfNextUse is 
Unchangeable. Inherited from Changeable. 

Accesses the specified Changeable data member, processes it, and 
returns a reference to the member. This reference should then be 
reassigned to the original member variable. Classes that derive from 
Changeable call this method on data members before they can be 
retrieved through property calls. Inherited from Changeable. 
Processes a modified Changeable data member and returns a 
reference to the processed object. Inherited from Changeable. 

Determines whether two Object instances are equal. Inherited from 
Object. 

Allows an Object to attempt to free resources and perform other cleanup 
operations before the Object is reclaimed by garbage 
collection. Inherited from Object. 

Horizontal DPI of the image. Inherited from ImageEffect. 

Vertical DPI of the image. Inherited from ImageEffect. 

Inherited from ImageEffect. 

Serves as a hash function for a particular type, suitable for use in 
hashing algorithms and data structures like a hash table. Inherited from 
Object. 

Required by ImageEffect 
Inherited from ImageEffect. 

Get a palette for a particular output Inherited from ImageEffect. 
Height, in pixels, of the image. Inherited from ImageEffect. 
Width, in pixels, of the image. Inherited from ImageEffect. 
These values contain the horizontal and vertical scale applied to this 
source. There are occasions when an effect needs to operate at a 
different resolution or a different coordinate space than the current, 
logical coordinate space. Thus, these properties enable the consumer to 
map between local space and ImageEffectSource space. Inherited from 
ImageEffect. 

Inherited from ImageEffect. 

Gets the Type of the current instance, inherited from Object. 
Default Constructor 

Makes an object immutable; after this method is called on a 
Changeable, its IsChangeable property is false. Inherited from 
Changeable. 

Makes a Changeable object immutable. Inherited from Changeable. 
Creates a shallow copy of the current Object. Inherited from Object. 
Adds or removes a Changed event handler to or from the specified 
Changeable object, if the object is currently modifiable. If the specified 
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object is not modifiable— if its IsChangeable property is false— this 
method has no effect. Inherited from Changeable. 
Called when the current object is modified. Classes that derive from 
Changed should call this method after they have been 
modified. Inherited from Changeable. 

Shares a Changed event handler with the current object's data 
members or removes it. Inherited from Changeable. 
Ensures that simple (non-Changeable) members are being accessed 
from a valid Ul context. This method should be called before any simple 
members are accessed. Inherited from Changeable. 

Determines whether the specified Object instances are the same 
instance. Inherited from Object. 

Returns a String that represents the current Object. Inherited from 

Object. 

Verifies that the current object has a valid state. If the object is in an 
invalid state, this method throws an exception. Inherited from 
Changeable. 

Causes the current object to validate itself and then invokes the 
OnChanged method. Inherited from Changeable. 
Ensures that simple (non-Changeable) members are being accessed 
from a valid user interface (Ul) context. This method should be called 
before any simple members are set. Inherited from Changeable. 



Property 



j 



Description 

Used in conjunction with the ChangeableUsageOverride type sent in 
AllowChangeableReferenceOverride as a P arameter to ChangeableHeiper.UseChangeable, to help 

determine when a Changeable being put into "use" should be 
promoted to "ChangeableReference". Inherited from Changeable. 
How much to sharpen 

True if this Changeable can be made unchangeable. Inherited from 
Changeable. 

This is the first input, and is an alias for lnputs[0] Perfomance 
Warning: If the input of the effect IS NOT in a format that the effect 
supports the effect wiil convert the input to a workable format for 
you. Inherited from ImageEffect. 

This is the collection of inputs Inherited from ImageEffect. 
Gets a Boolean that indicates whether the object is currently 
modifiable. Inherited from Changeable. 

This is the first output, and is an alias for Outputs[0] Inherited from 
ImageEffect. 

This is the collection of outputs Inherited from ImageEffect. 
The radius of the blur performed before sharpening 
Gets or sets a UseStatus enumeration that specifies how the 
Changeable object behaves when it is "used." A Changeable object 
is considered used in the following situations: the object is set into a 
Property System property, the object is used as a sub-object in a 
complex Changeable object, or the object is used in a 
DrawingContext command. Inherited from Changeable. 



Amount 

CanMakeUnchangeable 

Input 
Inputs 

IsChangeable 

Output 

Outputs 
Radius 



StatusOfNextUse 



UlContext 



Gets the UlContext of the current object. The UlContext is used for 
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maintaining thread safety. Inherited from Changeable. 



ImageEffectS urce Class 

Definition: ImageEffectSource class implementation. 



Method 

CanConvertTo 
CloneCore 

CloneDownToUnchangeable 

Copy 
Copy 

Copy 

EmbeddedChangeableReader 

EmbeddedChangeableWriter 

Equals 
Finalize 

GetHashCode 

GetThumbnail 
GetType 

ImageEffectSource 

MakeUnchangeable 

MakeUnchangeableCore 
MemberwiseClone 

ModifyHandlerlfChangeable 
OnChanged 

PropagateEventHandler 
ReadPreamble 



Description 

Gets or sets a value that indicates whether the image source can 
convert its data to the specified format. Inherited from ImageSource. 

Returns an immutable copy of the specified object. Inherited from 
Changeable. 

Copies the pixel data from the image into an array of pixels. Inherited 
from ImageSource. 

ImageSource abstract method implementation 

Returns a modifiable copy of the current object. The copy's 

IsChangeable property is true and its StatusOfNextUse is 

Unchangeable. Inherited from Changeable. 

Accesses the specified Changeable data member, processes it, and 

returns a reference to the member. This reference should then be 

reassigned to the original member variable. Classes that derive from 

Changeable cali this method on data members before they can be 

retrieved through property calls. Inherited from Changeable. 

Processes a modified Changeable data member and returns a 

reference to the processed object. Inherited from Changeable. 

Determines whether two Object instances are equal. Inherited from 
Object. 

Inherited from ImageSource. 

Serves as a hash function for a particular type, suitable for use in 
hashing algorithms and data structures like a hash table. Inherited from 
Object. 

Returns a thumbnail of the image. Inherited from ImageSource. 
Gets the Type of the current instance. Inherited from Object. 
Constructor 

Makes an object immutable; after this method is called on a 
Changeable, its IsChangeable property is false. Inherited from 
Changeable. 

Creates a shallow copy of the current Object, inherited from Object. 
Adds or removes a Changed event handler to or from the specified 
Changeable object, if the object is currently modifiable. If the specified 
object is not modifiable— if its IsChangeable property is false—this 
method has no effect. Inherited from Changeable. 
Called when the current object is modified. Classes that derive from 
Changed should call this method after they have been 
modified. Inherited from Changeable. 

Ensures that simple (non-Changeable) members are being accessed 
from a valid Ul context. This method should be called before any simple 
members are accessed. Inherited from Changeable. 
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Determines whether the specified Object instances are the same 
instance. Inherited from Object. 

Returns a String that represents the current Object. Inherited from 
Object. 

Verifies that the current object has a valid state. If the object is in an 
invalid state, this method throws an exceDtion. Inherited from 
Changeable. 

Causes the current object to validate itself and then invokes the 

OnChanged method. Inherited from Changeable. 

Ensures that simple (non-Changeable) members are being 

from a valid user interface (Ul) context. This method should be~calied 

before any simple members are set. Inherited from Changeable. 



Property 



Description 

Used in conjunction with the ChangeableUsageOverride type sent in 
AllowChangeableReferenceOverride as a P arameter to ChangeableHeiper.UseChangeable, to help 

determine when a Changeable being put into "use" should be 
promoted to M ChangeableReference , \ Inherited from Changeable. 

True if this Changeable can be made unchangeable. Inherited from 
Changeable. 

Horizontal DPI of the image. 
Vertical DPI of the image. 

Gets the embedded color profile if one exists. Inherited from 
ImageSource. 

Gets the embedded thumbnail if one exists. Inherited from 
ImageSource. 



CanMakeUnchangeable 

DpiX 
DpiY 

EmbeddedColorProfile 



EmbeddedThumbnail 
Format 



Height 

ImageEffect 
InternalBitmapSource 

IsChangeable 

MetaData 

Null 

Palette 

PixelHeight 

PixelWidth 

ScaleX 

ScaleY 



Gets the height of the image in measure units (1/96 of an 
inch). Inherited from ImageSource. 

This provides access to the effect from which this source came. 
ImageSource abstract method implementation 
Gets a Boolean that indicates whether the object is currently 
modifiable. Inherited from Changeable. 

Gets the metadata of the image. Inherited from ImageSource. 
Gets an empty image source, i.e., an image source with 0 width and 
0 height. Inherited from ImageSource. 
Get a palette 

Height, in pixels, of the image. 
Width, in pixels, of the image. 

These values contain the horizontal and vertical scale applied to this 
source. There are occasions when an effect needs to operate at a 
different resolution or a different coordinate space than the current, 
logical coordinate space. Thus, these properties enable the 
consumer to map between local space and ImageEffectSource 
space. 



StatusOfNextUse 



Gets or sets a UseStatus enumeration that specifies how the 
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Changeable object behaves when it is "used." A Changeable object 
is considered used in the following situations: the object is set into a 
Property System property, the object is used as a sub-object in a 
complex Changeable object, or the object is used in a 
Drawing Con text command. Inherited from Changeable. 

UlContext Gets th © UlContext of the current object. The UlContext is used for 

maintaining thread safely, inherited from Changeable. 

Width Gets the width of the im age Jn measure units (1/96 of an 

inch), inherited from imageSource. 



ImageEffectSourceCollection Class 

Definition: The collection of image effect outputs. 



Method 

CopyTo 



Finalize 



GeiEi i u met ator 

GetHashCode 

GetType 

MemberwiseClone 
MoveNext 

Referencetquais 

Reset 

ToString 



Description 

Copies the entire ImageEffectSourceCollection to a compatible one-dimensional 
Array, starting at the specified index of the target array. 

Determines whether two Object instances are equal. Inherited from Object. 
Allows an Object to attempt to free resources and perform other cleanup 
operations before the Object is reclaimed by garbage collection, inherited from 
Object. 

Returns an enumerator to iterate through the outputs 

Serves as a hash function for a particular type, suitable for use in hashing 

algorithms and data structures iike a hash tabie. inherited from Object. 

Gets the Type of the current instance. Inherited from Object. 

Creates a shallow copy of the current Object. Inherited from Object. 

Moves the enumerator to the next element in the collection: returns false if beyond 
end. 

Determines whether the specified Object instances are the same 
instance. Inherited from Object. 

Moves the enumerator to the next element in the collection; returns false if beyond 
end. 

Returns a String that represents the current Object. Inherited from Object. 



Property Description 

Count Get count of outputs. 

Current Returns the current element in the enumeration 

IsSynchronized Returns whether the object is thread-safe 

Item Indexer for returning a specific image effect output from the collection. The index must be 

in the range: (Count > maxOutputs >= 0) 

SyncRoot Returns the underlying root object for which synchronization occurs. 



ImageSourceConverter Class 

Definition: ImageSourceConverter 

Method Description 

Can Go n vert F rom CanConvertFrom 
CanConvertFrom Inherited from TypeConverter. 
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CanConvertTo 
CanConvertTo 
ConvertFrom 
ConvertFrom 

ConvertFromlnvariantString 

ConvertFromString 

ConvertTo 

ConvertTo 

ConvertTolnvariantString 

ConvertToString 

Createlnstance 

Equals 
Finalize 

GetConvertFromException 

GetConvertToException 

GetCreatelnstanceSupported 

GetHashCode 

GetProperties 

GetPropertiesSupported 

GetStandardValues 

GetStandardValuesExclusive 

GetStandardValuesSupported 

GetType 

ImageSourceConverter 
IsVaiid 

MemberwiseClone 

ReferenceEquals 

SortProperties 
ToString 



Inherited from TypeConverter. 
TypeConverter method override. 
Inherited from TypeConverter. 
ConvertFromString 
Inherited from TypeConverter. 
Inherited from TypeConverter. 
Inherited from TypeConverter. 
TypeConverter method implementation. 
Inherited from TypeConverter. 
Inherited from TypeConverter. 
Inherited from TypeConverter. 

Determines whether two Object instances are equal. Inherited from 
Object. 

Allows an Object to attempt to free resources and perform other cleanup 
operations before the Object is reclaimed by garbage collection. Inherited 
from Object. 

Inherited from TypeConverter. 
Inherited from TypeConverter. 
Inherited from TypeConverter. 

Serves as a hash function for a particular type, suitable for use in hashing 
algorithms and data structures like a hash table. Inherited from Object. 
Inherited from TypeConverter. 
Inherited from TypeConverter. 
Inherited from TypeConverter. 
Inherited from TypeConverter. 
Inherited from TypeConverter. 

Gets the Type of the current instance. Inherited from Object. 
Inherited from TypeConverter. 

Creates a shallow copy of the current Object. Inherited from Object. 

Determines whether the specified Object instances are the same 
instance. Inherited from Object 

Inherited from TypeConverter. 

Returns a String that represents the current Object. Inherited from Object 



IntegerCollection Class 
Method 

Add 

AddRange 

Clear 
CloneCore 

CloneDownToUnchangeable 
Contains 



Description 



Keturns an immutabie copy of the specified object, inherited from 
Changeable. 
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Copy 

Copy 
CopyTo 



Returns a modifiable copy of the current object The copy's 
IsChangeable property is true and its StatusOfNextUse is 
Unchangeable. Inherited from Changeable. 



Accesses the specified Changeable data member, processes it, and 
returns a reference to the member. This reference should then be 
EmbeddedChangeableReader reassigned to the original member variable. Classes that derive from 

Changeable call this method on data members before they can be 
retrieved through property calls. Inherited from Changeable. 
Processes a modified Changeable data member and returns a 
reference to the processed object. Inherited from Changeable. 

Determines whether two Object instances are equal. Inherited from 

Object. 

Allows an Object to attempt to free resources and perform other cleanup 
operations before the Object is reclaimed by garbage 
collection. Inherited from Object 



EmbeddedChangeableWriter 
Equals 



Finalize 



GetEnumerator 

GetHashCode 

GetRange 
GetType 

lAddChild.AddChild 

lAddChild.AddText 

IListAdd 

IListContains 

IListlndexOf 

IListlnsert 

IList Remove 

IndexOf 

Insert 

InsertRange 

IntegerCollection 

LastlndexOf 

MakeUnchangeable 

MakeUnchangeableCore 
MemberwiseClone 

ModifyHandlerlfChangeable 



OnChanged 
PropagateEventHandler 



Serves as a hash function for a particular type, suitable for use in 
hashing algorithms and data structures like a hash table. Inherited from 
Object. 

Gets the Type of the current instance. Inherited from Object 



Makes an object immutable; after this method is called on a 
Changeable, its IsChangeable property is false. Inherited from 
Changeable. 

Makes a Changeable object immutable. Inherited from Changeable. 
Creates a shallow copy of the current Object. Inherited from Object 
Adds or removes a Changed event handler to or from the specified 
Changeable object, if the object is currently modifiable. If the specified 
object is not modifiable— if its IsChangeable property is false— this 
method has no effect Inherited from Changeable. 
Called when the current object is modified. Classes that derive from 
Changed should call this method after they have been 
modified. Inherited from Changeable. 

Shares a Changed event handler with the current object's data 
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members or removes it. Inherited from Changeable. 
Ensures that simple (non-Changeable) members are being accessed 
from a valid user interface (Ul) context. This method should be called 
before any simple members are accessed. Inherited from Changeable. 
Determines whether the specified Object instances are the same 
instance. Inherited from Object. 



Returns a String that represents the current Object. Inherited from 
Object. 

Verifies that the current object has a valid state. If the object is in an 
invalid state, this method throws an exception. Inherited from 
Changeable. 

Causes the current object to validate itself and then invokes the 
OnChanged method. Inherited from Changeable. 
Ensures that simple (non-Changeable) members are being accessed 
from a valid Ul context. This method should be called before any simple 
members are set. Inherited from Changeable. 



Property Description 

Used in conjunction with the ChangeableUsageOverride type sent in 

AllowChangeableReferenceOverride as a P arameter t0 ChangeableHelper.UseChangeable, to help 

determine when a Changeable being put into "use" should be 
promoted to "ChangeableReference". Inherited from Changeable. 

True if this Changeable can be made unchangeable. Inherited from 
Changeable. 



CanMakeUnchangeable 

Capacity 
Count 

IsChangeable 

IsFixedSize 
Item 



StatusOfNextUse 



UlContext 



Gets a Boolean that indicates whether the object is currently 
modifiable. Inherited from Changeable. 



Gets or sets a UseStatus enumeration that specifies how the 
Changeable object behaves when it is "used." A Changeable object 
is considered used in the following situations: the object is set into a 
Property System property, the object is used as a sub-object in a 
complex Changeable object, or the object is used in a 
DrawingContext command. Inherited from Changeable. 
Gets the UlContext of the current object. The UlContext is used for 
maintaining thread safety. Inherited from Changeable. 



IntegerCollecti nConverter Class 
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Definition: IntegerCollectionConverter - Converter class for converting instances of other types to and 
from Integer-Collection instances. 



Meth d 

CanConvertFrom 

CanConvertFrom 

CanConvertTo 

CanConvertTo 

ConvertFrom 
ConvertFrom 

ConvertFromlnvariantString 

ConvertFromString 

ConvertTo 

ConvertTo 

ConvertTolnvariantString 

ConvertToString 

Createlnstance 

Equals 
Finalize 

GetConvertFromException 

GetConvertToException 

GetCreatelnstanceSupported 

GetHashCode 

GetProperties 

GetPropertiesSupported 

GetStandardValues 

GetStandardValuesExclusive 

GetStandardValuesSupported 

GetType 

IntegerCollectionConverter 
IsValid 

MemberwiseClone 
ReferenceEquais 
SortProperties 
ToString 



Description 

Inherited from TypeConverter. 

CanConvertFrom - Returns whether or not this class can convert from a 
given type. 

Inherited from TypeConverter. 

CanConvertTo - Returns whether or not this class can convert to a given 
type. 

ConvertFrom - Attempt to convert to a IntegerCollection from the given 
object 

Inherited from TypeConverter. 
Inherited from TypeConverter. 
Inherited from TypeConverter. 

ConvertTo - Attempt to convert a IntegerCollection to the given type 
Inherited from TypeConverter. 
Inherited from TypeConverter. 
Inherited from TypeConverter. 
Inherited from TypeConverter. 

Determines whether two Object instances are equal. Inherited from 
Object. 

Allows an Object to attempt to free resources and perform other cleanup 
operations before the Object is reclaimed by garbage 
collection. Inherited from Object. 
Inherited from TypeConverter. 
Inherited from TypeConverter. 
Inherited from TypeConverter. 

Serves as a hash function for a particular type, suitable for use in 
hashing algorithms and data structures like a hash table. Inherited from 
Object 

Inherited from TypeConverter. 
Inherited from TypeConverter. 
Inherited from TypeConverter. 
Inherited from TypeConverter. 
Inherited from TypeConverter. 

Gets the Type of the current instance. Inherited from Object. 
Inherited from TypeConverter. 

Creates a shallow copy of the current Object. Inherited from Object. 
Determines whether the specified Object instances are the same 
instance. Inherited from Object. 

Inherited from TypeConverter. 

Returns a String that represents the current Object. Inherited from 
Object. 



LinearGradientBrush Class 
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Definition: Defines a linear gradient used to fill an area. 



Meth d 

AddStop 
CioneCore 
ClnneOorft 

CioneDownToUnchangeabie 
Copy 

Copy 

Copy 

Copy 

DeserializeFrom 
DisableCore 

EmbeddedAnimationCoilectionReader 
EmbeddedAnimationCollectionWriter 
EmbeddedChangeableReader 
EmbeddedChangeableWriter 
EnableCore 

Equals 

Finalize 

GetCurrentValue 
GetCurrentValue 



GetCurrentValue 

GetCurrentValue 

GetHasAnimations 
GetHashCode 



Description 

Adds a gradient stop to the brush, inherited from GradientBrush. 
Returns a modifiable shallow or deep clone of the current object. 
This abstract method must be implemented bv classes that 
derive from Changeable. Inherited from Changeable. 
ImplemRntatinn nf Animatahlft ClnnROnre 

Returns an immutable copy of the specified object Inherited 
from Changeable. 

Returns a modifiable copy of the brush. The copy's 
IsChangeable property is true and its StatusOfNextUse is 
Unchangeable. Inherited from Brush. 

Returns a modifiable copy of the brush. The copy's 
IsChangeable property is true and its StatusOfNextUse is 
Unchangeable. Inherited from GradientBrush. 
Returns a modifiable copy of the current object. The copy's 
IsChangeable property is true and its StatusOfNextUse is 
Unchangeable. Inherited from Changeable. 
Returns a modifiable copy of the brush. The copy's 
IsChangeable property is true and its StatusOfNextUse is 
Unchangeable. 

Returns a new Brush initialized from the binary representation 
being read by the passed BinaryReader. Inherited from Brush. 
Inherited from GradientBrush. 

Maybe this should be internal?? Inherited from Animatable. 
Inherited from Animatable. 
Inherited from Animatable. 
Inherited from Animatable. 
Inherited from GradientBrush. 

Determines whether two Object instances are equal. Inherited 
from Object. 

inherited from Brush. 

Returns a non-animated version of this GradientBrush that 
represents its current state. Inherited from GradientBrush. 
Returns the current value of the brush. The returned brush has 
the same value as the current object, but doesn't vary over time. 
That is, the returned brush is a snapshot of the current object at 
the point in time at which this method was called. 
Returns the current value of the brush. The returned brush has 
the same value as the current object, but doesn't vary over time; 
that is, the returned brush is a snapshot of the current object at 
the point in time at which this method was called. Inherited from 
Brush. 

Returns a non-animated version of this Animatable that 
represents its current state. Inherited from Animatable. 

Inherited from Brush. 

Serves as a hash function for a particular type, suitable for use in 
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GetlsAnimating 

GetlsOverridingBaseValue 

GetType 

LinearGraciientBrush 
MakeUnchangeable 
MakeUnchangeableCore 



ModifyHandlerlfChangeable 
OnChanged 

PropagateEventHandler 

Read Preamble 

ReferenceEquals 
SerializeOn 

SetDefaultParentTimeline 

SotnafaijItPorontTifTieilne 

ToString 

VaiidaieObjectSiate 
WritePostscript 

WriiePreambie 



hashing algorithms and data structures like a hash 
table. Inherited from Object. 

Inherited from Brush. 

Inherited from Brush. 

Gets the Type of the current instance. Inherited from Object. 

initializes a new instance of the LinearGradientBrush ciass. 

Makes an object immutable; after this method is called on a 
Changeable, its IsChangeable property is false. Inherited from 
Changeable. 

Inherited from GradientBrush. 

Creates a shallow copy of the current Object. Inherited from 
Object. 

Adds or removes a Changed event handler to or from the 
specified Changeable object, if the object is currently modifiable. 
If the specified object is not modifiable — if its IsChangeable 
property is false — this method has no effect. Inherited from 
Changeable. 

Called when the current object is modified. Classes that derive 
from Changed should call this method after they have been 
modified. Inherited from Changeable. 

Ensures that simple (non-Changeable) members are being 
accessed from a valid Ul context. This method should be called 
before any simple members are accessed. Inherited from 
Changeable. 

Determines whether the specified Object instances are the same 
instance. Inherited from Object. 

Serialize this object using the passed writer Inherited from Brush. 
Inherited from Brush. 

This will change the time parent for animations on any of the 
properties of this Changeable which are inheriting their time 
parent. Inherited from Animatable. 



Returns a String that represents the current Object. Inherited 
from Object. 

Verifies that the current object has a valid state. If the object is in 
an invalid state, this method throws an exception, inherited from 
Changeable. 

Causes the current object to vaiidate itseif and then invokes the 
OnChanged method. Inherited from Changeable. 

Ensures that simple (non-Changeable) members are being 
accessed from a valid user interface (Ul) context. This method 
shouid be called before any simpie members are sei. inherited 
from Changeable. 



Property Description 

Used in conjunction with the ChangeableUsageOverride type sent in 

AllowChanaeableReferenceOverride as a Parameter to ChangeableHelper.UseChangeable, to help 

aetermme wnen a unangeaDie Deing put imo use snouia De 
promoted to "ChangeableReference". Inherited from Changeable. 
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CanMakeUnchangeable 



uoionnierpoiationivioae 



DefaultParentTimeline 
EndPoint 

EndPointAnimations 

GradientStops 

HasAnimations 
IsAnimating 

IsChangeable 
IsOverridingBaseValue 

MappingMode 
Opacity 

OpacityAnimations 

SpreadMethod 
StartPoint 

StartPointAnimations 
StatusOfNextUse 

Transform 
UlContext 



True if this Changeable can be made unchangeable. Inherited from 
Changeable. 

ColorlnterpolationMode - Read only accessor of the 
ColorlnterpolationMode property. This property controls how the 
colors in Gradient are interpolated. Defauit is 
ColorlnterpolationMode.PerceptuallyLinearGamma. Inherited from 

G rad ie n tS rush. 

The current parent Timeline associated with this Animatable. This 
wiii be the Timeline set io the PaientTirneiine property of this 
Animatable if one has been set and if not, the Timeline last passed 

ii tiu it iw" wciL^ciauiu aicuu imciuic men iuu. 1111101 itou mwiii 

Animatable. 

Gets or sets the ending two-dimensional coordinates of the linear 
gradient. 

Geis or seis a coiiection of Pointfvlodifier objects thai animate the 
brush's EndPoint property. 

Gets or sets the gradient stops (transition points) of a 
brush. Inherited from GradientBrush. 

Gets a Boolean that indicates whether the brush has animations. 



Gets a Boolean that indicates whether the object is currently 
modifiable. Inherited from Changeable. 

Gets a Boolean that indicates whether the LinearGradientBrush is 
currently animated. 

Gets or sets a BrushMappingMode enumeration that specifies 
whether the gradient brush's positioning coordinates are absolute or 
relative to the output area, inherited from GradientBrush. 

Gets or sets the degree of opacity of a Brush. Inherited from Brush. 

Gets or sets the animations associated with the Opacity of the 
brush. Inherited from Brush. 

Gets or sets the type of spread method that specifies how to draw a 
gradient that starts or ends inside the bounds of the object to be 
painted, inherited from GradientBrush. 

Gets or sets the starting coordinates of the linear gradient. 

Gets or sets a collection of PointModifier objects that animate the 
brush's StartPoint property. 

Gets or sets a UseStatus enumeration that specifies how the 
Changeable object behaves when it is "used." A Changeable object 
is considered used in the foiiowing situations: the object is set into a 
Property System property, the object is used as a sub-object in a 
complex Changeable object, or the object is used in a 
DrawingContext command. Inherited from Changeable. 

Geis or seis a transformation thai is appiied io ihe brush. This 
transformation is applied after all other mapping and positioning 
have been processed. Inherited from Brush. 

Gets the UlContext of the current object. The UlContext is used for 
maintaining thread safety. Inherited from Changeable. 



ThiS example demonstrates hOW to USe the Transform uiouefty Of brushes tu apply transformations to 

LinearGradientBrush and RadialGradientBrush fills. A LinearGradientBrush is used to fill the first two 

Dor»t»annlo olomonfc Tho H iffo ron^o KoKn/oon tho ror>t«annloe ie fho* tho I inonrOror(iontRri ich in tho coonnH 
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rectangle is rotated 45 degrees. The second pair of rectangles illustrates the before and after effect of a 
ScaleTransform by reducing a RadialGradientBrush to half its normal height. 

<Border xmlns-Mp://schemas.microsoft.com/2003/xaml M 
Background= H #CCCCCC n > 

<Canvas Height="40 n > 

<i- Rectangie #i is fiiied with a LinearGradientBrush. The gradient coiors 
flow from left to right by default. -> 

<Rectangle Rectang!eLeft="10" RectangleTop= M 10" 
RectangleWidth= M 300" RectangleHeight="200"> 

<Rectangle.Fill> 
<LinearGradientBrush> 

<LinearGradientBrush.GradientStops> 
<GradientStopCollection> 
<GradientStop Coior= :: red :: Offset= !: 07> 
<GradientStop Color="yellow" Offset= ,, 1" /> 

i:_ r>-i-^iiLi..-ti r\««.t_nn c»»/^ 

^vjiauiciuoiu|j uuiui- uiuc v-mi»ci— kj.o /«"* 

<GradientStop Color="white" Offset="0.27> 
</GradientStcpCo!!ection> 
</LinearGradientBrush.GradientStops> 

</LinearGradientBrush> 
</Rectangle.Fill> 

</Rectangle> 



<!- Rectangle #2 is identical to the first rectangle except that the Transform 
property rotates the LinearGradientBrush so that the gradient colors are 
rotated by 45 degrees. -> 

^ r~> *. t ~ r^~~*. i_i n-*4--«i-T-.-_iM/Mi 

^r\cuicauyic rvcuictnyicLcu— o^u rxcuianyic i up— iu 

RectangleWidth="300" RectangleHeight="200"> 

<Rectangle.Fill> 
<LinearGradientBrush> 

<LinearGradientBrush.Transform> 

<RotateTransform Angle- '45" /> <!- Rotation angle. ~> 
</LinearGradientBrush.Transform> 

-i : 1: *r> u 1: 101 . 

^LincaioiduiciiiDi udi i.otciuici noiupd^ 

<GradientStopCollection> 

<GradientSto r4 Cc!cr r ". r 9d" Offset="0'7> 

<GradientStop Color= M yellow M Offset= ,, 1" /> 

<GradientStop Color="blue M Offset="0.57> 

<GradientStop Color="white n Offset="0.2'7> 
</GradientStopCollection> 
</LinearGradientBrush.GradientStops> 

</LinearGradientBrush> 
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</Rectangle.Fill> 
</Rectangie> 



<!- Rectangle #3 is filled with a RadialGradientBrush. --> 

<Rectangie RectangieLeft= :: iO ;: ReciangieTop= i: 250 :: 
RectangleWidth= n 300" RectangleHeight="200"> 

<Rectangle.Fill> 
<RadialGradientBrush Focus^'O.S.O.S^ 

<RadialGradientBrush.GradientStops> 
<GradientStopCollection> 
<GradientStop Coior= 5 ted :f Gffset="07> 
<GradientStop Color^'yellow" Offset="17> 

<oiauiciuoiup uuiui — uiuc unaci- u.u 

</GradientStopCollection> 
</Radia!GradientBrush.Gr3dientStops> 

</RadialGradientBrush> 
</Rectangle.Fill> 

</Rectangie> 

<!- Rectangle #4 is identical to the third rectangle except that the Transform 
property applies a ScaleTransform to the RadialGradientBrush so that the 
gradient is naif its previous height. -> 

^t-\ — —i. i _ r-i _ ~ — i — i -ft-tionnn f» i> t ~~r noirnii 

<ReCtangle rxcwicniyieucu- o^u r\euicaiiyie i uu- ^ju 

RectangleWidth="300 M RectangleHeight="200 M > 

<Rectangle.Fill> 

<RadiaiGradientBrush Focus= :: 0.5,0.5 :: > 
<RadialGradientBrush.Transform> 

<ScaleTransform ScaieX= n r' ScaieY="0.5" /><!- Scale transform. -> 
</RadialGradientBrush.Transform> 

<RadialGradientBrush.GradientStops> 
<GradientStopCollection> 
<GradientStop Coior= :: red :: Offset= :: 07> 
<GradientStop Color^'yellow" Offset='T7> 

^,r^ j: ir>i ^.i._<iui...h /^<x—— .* i»n 

</GradientStopCollection> 
</Radia!GradientBrush.Gradiep.tStcps> 

</Radia!GradientBrush> 
</Rectangle.Fill> 

</Rectangie> 

</Csnvas > 
</Border> 
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This example creates simple vertical, horizontal, and radial gradients and uses them to fill an element 
using "Longhorn" markup language (code-named "XAML"). 

In the following example, vertical and horizontal gradients are used to set the Fill property of two 
Rectangle elements. In this particular example, the gradients are described using simple notation: 
GradientType StariCoior EndCoior, where GradientType is VerticaiGradient, HorizontaiGradient, or 
RadialGradient. StartColor and EndCoior can be predefined color names (such as Blue) or hexadecimal 

values. 

<Canvas xm!ns= ,, http://schemas.microscft.com/2003/xam!"> 

<Rectangle 

Fill="VerticalGradient Blue Green" 

RectangleLeft="20" 

RectangleTop="20" 

RectangleWidth="100" 

RectangieHeight= :: 1 00 !: > 
</Rectangle> 

<Rectangle 
Fill="HorizontalGradient Blue Red" 
RectangieLeft="i20" 
RectangleTop="120 n 

O - nmlotAI! J*U —II A Aft" 

RectangleHeight="100"> 
^/Rectangle^ 

A vertical gradient is a linear gradient whose start and endpoints form a vertical line; likewise, a horizontal 
gradient is a linear gradient whose start and endpoints form a horizontal line. You can explicitly describe 
your own linear gradients using the following syntax: 

LinearGradient StartPoint EndPoint StartColor EndCoior, where StartPoint and EndPoint are the starting 
and ending coordinates, with each coordinate expressed as a pair of x and y values from 0 to 1, such as 
0.1,0. i and 0.5,0.5. These vaiues indicate the relative position of the start or end point. An endpoint of 
0.5,0.5 would be located 50 percent to the right of the fill area and 50 percent of the way from the top of 

*.i — _ ii — — ~c ii — _i 

ii ic a i cct — me iimuuic ui me onapc. 

In tho fr\llrk\ ii/inn ovomnla tho Pill r\rnnort\/ r\i a Portonnla olomont ic cot hw ovnlir»itl\/ i icinn a lincsar 

• •I hi IW IVIIWIIIIIVJ W/XMI I IfSIW, hi I W I III (Jl ij W I h* I WWhWAI lyiV N^IWI I IWI It IV WVIi J V/V|/IIWIVI J WIWII Wl III I WW*! 

gradient. 
<Rectangle 

Fill="LinearGradient 0.1,0.1 0.5,0.5 Blue Green" 

RectangieLeft= :: 220 :! 

RectangleTop="220" 

i \cuiaiiy v viuu i— I \J\J 

RectangleHeight="100"> 
</Rectang!e> 

In the final example ; the Fill property of a Rectangle element is set using a radial gradient. 

<Rectangle 
Fill="RadialGradient Blue Red" 
RectangleLeft="320" 
RectangieTop= :: 320 :: 
RectangleWidth="100" 

r\ — i. 1 - i r\r\»^ 
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</Rectangle> 
</Canvas> 

See Create a Gradient with More Than Two Colors for an example of how to create a gradient with more 
than two gradient stops. 

To create vertical and horizontal gradients in code or using compound notation use the 
LinearGradientBrush class and set its StartPoint and EndPoint properties so that they describe a vertical 
or horizontal line. To create radial gradients in code or using compound notation, use the 
RadialGradientBrush class. 

This example demonstrates how to create a gradient that has more than two colors in "XAML". To create 
a gradient with more than two colors, add a GradientStopCollection to the gradient's GradientStops 
property. Next, add GradientSiop objects to the GradientStopCoiieciion, one for each coior the gradieni 
should contain. Set the Color and the Offset, a value from 0 to 1 that determines the relative position of 
the stop m the gradient, of each of the stops. The following example shows a Button whose Background 
is filled with a horizontal gradient that has four colors. 

<Canvas ID= M root" 
xmlns="http://schemas.microsoft.com/2003/xamr , > 

< Button 
Canvas.Top="50" 
Canvas. Left= :: 50 :: 
BorderBrush="Black M 

vviuui- ^uu 

Height="30"> 

<rRi ittrvn Rar*Lrnrr\i inH^ 

<LinearGradientBrush > 
<LinearGradientBrush.GradientStops> 
<GradientStopColiection> 
<GradientStop Color="Red" Offset="0" /> 
<GradientStop Color="Blue" Offset="0.257> 
<GradientStop Color="Orange" Offset="G\757> 
<GradieniStop Coior= :i Yeiiow : Offset= : T7> 
</GradientStopCollection> 
</LinearGradieniBrush.Gradieni3tops> 
</LinearGradientBrush> 
</Button.Background> 
</Button> 

</Canvas> 



LineGeometry Class 

Definition: Represents the geometry of a line. 



Method 



CloneCore 



CloneCore 

CloneDownToUnchangeable 



Description 

Roturnc a mnHifiahlo challn\A/ nr Hoon Hnno nf tho rtirront nhiort 

' — . w .. ~, 1 • J 

This abstract method must be implemented by classes that derive 
from Changeable. Inherited from Changeable. 

Implementation of Animatable.CloneCore. 

Returns an immutable copy of the specified object. Inherited from 
Changeable. 
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Copy 



Copy 
Copy 



Dispose 
DoesContain 

EmbeddedAnimationCollectionReader 

EmbeddedAnimationCollectionWriter 

EmbeddedChangeableReader 

PmhoHHoHPlhannoaNoWritor 

—«••*»*■"- . w. 

EnableCore 

Equals 

Finalize 

f^otRoi inHc 



oeiourrenivaiue 



GetHashCode 



GetType 



ft A ^.1,^1 | nM U nnM />»UU 
iviaixcui 101 lai lycauic 



Tvlcikeunchai lyeabieCuie 
MemberwiseClone 

ModifyHandlerlfChangeable 
OnChanged 

PropagateEventHandier 
ReadPreamble 



Returns a modifiable copy of the current object. The copy's 
IsChangeable property is true and its StatusOfNextUse is 
Unchangeable. Inherited from Changeable. 

Creates a copy of this Geometry. Inherited from Geometry. 

Creates a copy of this LineGeometry. 



IMMCMICU M Will njcwii iv=u y . 



Releases the resources associated with the object. Inherited from 
Geometry. 

Returns if point is inside the geometry. Inherited from Geometry. 
Maybe this should be internal?? Inherited from Animatable. 
Inherited from Animatable. 
Inherited from Animatable. 
Inherited from Animatable. 
Inherited from Geometry. 

Determines whether two Object instances are equai. inherited 
from Object. 

inherited from Geometry. 

Returns the bounds of a Geometry, widened according to the 
characteristics of the specified pen. Inherited from Geometry. 

Returns a non-animated version of this LineGeometry that 
represents its current state. 

Returns a non-animated version of this Animatable that represents 
its current state. Inherited from Animatable. 

Returns a non-animated version of this Geometry that represents 
its current state. Inherited from Geometry. 

Serves a? a hash function for a particular type, suitable for use in 
hashing algorithms and data structures like a hash table. Inherited 
from Object. 

Gets the Type of the current instance. Inherited from Object. 

Initializes 3 new instance of the LineGecmetp/ class. 

Makes an object immutable; after this method is called on a 
Changeable, its SsChangeable property is false. Inherited from 
Changeable. 

Inherited from Geometry. 

Creates a shallow copy of the current Object. Inherited from 

Object. 

Adds or removes a Changed event handler to or from the 
specified Changeable object, if the object is currently modifiable. If 
the specified object is not modifiable — if its IsChangeable property 

is false — this method has no effect. Inherited from Changeable. 

Called when the current object is modified. Classes that derive 
from Changed shouid caii this method after they have been 
modified. Inherited from Changeable. 

Implementation of PropagateEventHandier. 

Ensures that simple (non-Changeable) members are being 
accessed from a valid Ul context. This method should be called 
before any simple members are accessed. Inherited from 
Changeabie. 
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ReferenceEquals 

SetDefaultParentTimeline 

SetDefaultParentTimelineCore 
ToString 

ValidateObjectState 
WritePostscript 

\A/ritoDraamhlo 



Determines whether the specified Object instances are the same 
instance. Inherited from Object. 

This will change the time parent for animations on any of the 
properties of this Changeable which are inheriting their time 
parent Inherited from Animatable. 

Inherited from Geometry. 

Returns a String that represents the current Object. Inherited from 

Object. 

Verifies that the current object has a valid state. If the object is in 
an invalid state, this method throws an exception. Inherited from 
Changeable. 

vouocg uic wumciu uwjcoi iu vqiiuqic ilocii unu men invwixGS uic 

OnChanged method. Inherited from Changeable. 
Ensures that Simple (non-Chang cable) members are being 
accessed from a valid user interface (Ul) context. This method 
should be called before any simple members are set inherited 
from Changeable. 



Property 

AllowChanqeableReferenceOverride 
Bounds 

CanMakeUnchangeable 
DefauitParentTimeiine 



Description 

Used in conjunction with the ChangeabieUsageOverride type sent in 
as a parameter to ChangeableHelper.UseChangeable, to help 
determine when a Changeable being put into "use" should be 
promoted to "ChangeableReference". Inherited from Changeable. 
Gets a Rect that specifies the bounding box of a LineGeometry. 
This method does not take any pens into account. 

True if this Changeable can be made unchangeable, inherited from 
Changeable. 

The current parent Timeline associated with this Animatable. This 
will be the Timeline set to the ParentTimeline property of this 
Animatabie if one has been sei and if not, the Timeiine iast passed 
into the SetDefaultParentTimeline method. Inherited from 



EndPoint 

EndPointAnimations 

HasAnimations 

IsAnimating 

IsChangeable 

IsOverridinqBaseValue 
StartPoint 

StartPointAnimations 



StatusOfNextUse 



Gets or sets the end point of a line. 

Gets or sets a collection of PointModifier objects that animate the 
line's EndPoint. 

Gets a Boolean that indicates whether the geometry has 
animations. 

Returns true if the geometry contains active animations. 

Gets a Boolean that indicates whether the object is currently 
modifiable. Inherited from Changeable. 

Gets or sets the start point of a line. 

Gets or sets a collection of PointModifier objects that animate a 
line's StartPoint. 

Gets or sets a D 36 Statu 3 6 n u m 6 rati o n that specifies how the 
Changeable object behaves when it is "used." A Changeable object 
is considered used in the following situations; the object is set into a 
Property System property, the object is used as a sub-object in a 
complex Changeable object, or the object is used in a 
DrawingContext command, inherited from Changeable. 
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Transform Gets or sets the Transform object applied to a Geometry. Inherited 

from Geometry. 

UlContext Gets the UIContext of the current object. The UlContext is used for 

' u Av maintaining thread safety. Inherited from Changeable. 

This example demonstrates how to draw shapes using the Geometry, PathFigure, and PathSegment 
classes. In this example, several shapes are drawn using Geometry objects and are displayed using a 
Math element. 

There is a Geometry class for each basic geometric shape: LineGeornetry, EliipseGeornetry, and 
RectangleGeometry. Complex shapes, such as polygons and shapes with curved segments, may be 

rrootoH neing o DathQagmafry 

In the following example, a LineGeometry ; EliipseGeornetry, and a RectangleGeometry object are used to 
create a line, an ellipse, and a rectangle. 

//c# 

MSAvalon. Windows. Media. LineGeornetry myLineGeometry = 
new LineGeometry(new Point(50, 50), new Point(300, 50)); 

ivionvcuun. vvmuuw^.ivicuia.citi^cocunicu y i iiy tiiipSeCjeOiTieu y = 

new EllipseGeometry(new Point(440, 100), 40, 75); 

MSAvalon.Windows.Media.RectangleGeometry myRectangleGeometry = 
new RectangleGeometry(new Rect(new Point(400, 225), new Size(100, 50))); 

'VB.NET 

Dim myLineGeometry As new MSA valon. Windows. Media. LineGeometry( _ 

new MSAvaion.Windows.Point(50, 50), new MSA vaion. Windows. Point(300, 50)) 
Dim myEllipseGeometry As new MSAvalon.Windows.Media.EllipseGeometry( _ 

new MSAvalon. Widows. Point(440, 100), 40, 75) 
Dim myRectangleGeometry As new MSAvalon. Windows.Media.RectangleGeometry( _ 

new MSA valon .Windows. Rect(new MSAvalon. Windows. Point(4 00,225) , 

new MSAvalon. Windows. Size( 1 00,50))) 



PathGeometry objects can be used to create complex shapes, such as arcs and curves. PathGeometry 
objects are comprised of one or more PathFigure objects; each PathFigure represents a different "figure" 
or shape, tach pathHgure is itseif comprised of one or more PathSegment objects, each representing a 
connected portion of the figure or shape. Segment types include the following: LineSegment, 

oc^iciocynicm, emu ni^ocymcm. 

In the following code, a PathGeometry and a PathFigure are created and several segments are added ^ 
the PathFigure to form a shape. There are several ways to add segments to a PathFigure; you can use 
the PathFigure object's "draw segment" commands to automatically create new segments and add them 
to the figure, or you can explicitly create segments and add them manually using the PathFigure object's 
Segments property or AddSegment method. This example shows both ways of adding segments to a 
figure. 

The first segment of a PathFigure must be a StariSegment. The StartSegment may be added by creating 
a new StartSegment and adding it to the PathFigure, or it can be added using the PathFigure object's 
StariAt method. The following code demonstrates adding a StartSegment using the StartAt method. The 
start point is set to (200,50). 

// C# 
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MSAvalon. Windows. Media. PathGeometry myPathGeometry = new PathGeometry(); 
MSAvalon.Windows.Media.PathFigure myPathFigure = new PathFigure(); 

// PathFigure objects must have a defined start point before 
// other segments can be added. 
myPathFigure.StartAt(new Point(200,50)); 



Dim myPathGeometry As new MSAvalon. Windows. Media. PathGeometry() 
Dim myPathFigure As new MSAvalon. Windows. Media. PathFigursO 

' PathFigure objects must have a defined start point before 
1 other segments can be added. 

myPathFigure.StartAt(new MSAvalon.Windows.Point(200,50)) 

In the following code, the BezierTo method is used to create three Bezier curves. A fourth curve is 
created by explicitly creating a BezierSegment and adding it to myPathFigure using the AddSegment 
method. After the segments are added to the PathFigure (myPathFigure), the PathFigure is added to the 
PathGeometry. 

// C# 

myPathFigure. BezierTo( 

new Point(400, 1 00), new Point(400, 200), new Poini(200, 300)); 

iiiyrauiriyuic.ucLici I \j\ 

new Point(400, 300), new Point(400, 100), new Point(200, 50)); 
myPathFigure. BezierTo( 

new Point(0, 100), new Point(0, 200), new Point(200,300)); 

MSAvalon. Windows. Media. BezierSegment myBezierSegment = 
new BezierSegment(new Point(0, 300), new Point(0, 100), new Point(200, 50), true); 

myPathFigure.AddSegment(myBezierSegment); 

myPathGeometry.Figures.Add(myPathFigure); 



myPathFigure. BezierTo(new MSAvalon. Windows. Point(400, 100), _ 
new MSAvalon. Windows. Pes nt(4 00, 200), new MSAvalon. Windows. Pcint(200 300)) 

myPathFtgure.BezierTo(new MSAvalon. Windows. Point(400 r 300V _ 
new MSAvalon. Windows. Point(400, 100), new MSAvalon. Windows. Point(200, 50)) 

myPathFigure.BezierTo(new MSAvalon. Windows. Point(0, 100), _ 
new MSAvalon. Windows. Point(0, 200), new MSA valon. Windows. Point(200,300)) 

Dim myBezierSegment As new BezierSegment( _ 
new MSAvalon. Windows. Point(0, 300), new MSA valon. Windows. Point(0, 100), _ 
new MSAvaion. Windows. Point(200, 50), true) 

myPathFigure.AddSegment(myBezierSegment) 

■ ahh tho PathFigure to the PathGeometry 
myPathGeometry.Figures.Add(myPathFigure) 
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In the final code example, the geometries are added to a GeometryCollection, and the 
GeometryCollection is used to set the Path element's Data property. Had there been only one geometry, 
it couid have been used to set the Data property directiy, without the GeomeiryCoiiection. 
//C# 

GeornetryCollection my GeometryCollection = new Geo rneiry Co ! ! ecti on ( ) ; 

myGeometryCollection.Add(myLineGeometry); 

my Geometry Go! lection . Add { m y E ! ! ipssGsom et. n /) ; 

myGeometryCollection.Add(myRectangleGeometry); 

myGeometryCollection.Add(myPathGeometry); 

Path myPath = new Path(); 
myPath.Data = myGeometryCollection; 

// Set the outiine and the fiii of the Path eiemeni. 
myPath.Stroke = Brushes.Blue; 

uiyrcun.ouurvc i murviicoo - new iyu 

SolidColorBrush solidFill = new SolidColorBrush(); 

my Path. Fi!! = new Radia!GradientBrush(Co!ors. Orange, Colors. Red); 

// Add the Path element to a Canvas. 
myCanvas.Children.Add(myPath); 

J VB .NET 

Dim myGeometryCollection As new MSAvalon.Windows.Media.GeometryCollection() 
my G 6 o rn 6* ry C o ! lection . Add ( m y !_ i n eGeorn etry) 
myGeometryCollection. Add(myEllipseGeometry) 
myG e cm etryCo! lecti on . Ad d(m y Recta ng leG eo m etry) 
myGeometryCollection.Add(myPathGeometry) 

Dim myPath As new Path() 
myPath.Data = myGeometryCollection 

' Set the outline and the fill of the Path element. 
myPath.Stroke = MSAvalon.Windows. Media. Brushes. Blue 
myPath.StrokeThickness = new MSAvaion. Windows. Lengih(5) 
Dim solidFill As new MSAvalon.Windows.Media.SolidColorBrush() 

iiiyrciui.riii — new rveiuiciioieiuieiiioi usii(ivionvaiun. vvmuuwcs.ivieu id. wGiOtS. Grange, _ 

MSAvalon.Windows. Media.Colors. Red) 

' Add the Path element to a Canvas. 
myCanvas.Children.Add(myPath) 

Geometry objects may also be rendered using the DrawingContext, which supplies a DrawGeometry 
method that may be used to render Geometry objects. Geometry objects may also be used for clipping 
and hit-testing. 

This example demonstrates how to draw shapes using the Geometry and Path elements in "Longhorn" 
markup language (code-named "XAML"). 

!n the following example, a Path is drawn on a Canvas. Several Geometry elements are assigned to the 
Path element's Data attribute. 
<Canvas ID="root" 
Background="White M 

xmlns= n http://schemas.microsoft.com/2003/xamr , > 



<Path ID="myPath" 
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Fill="Blue" 

Stroke="Black" 

SirokeThickness= r: 5 :? > 

N rau i. uaw 

<GeometryCollection> 

<LineGeometry StartPoint^'50,50" EndPoint= M 300,507> 
<EllipseGeometry Center="440, 100" RadiusX="40" RadiusY="757> 

<ReciangieGeometry > 
<RectangleGeometry.Rect> 

^rvcui /\- tuu i— ^.^.u vwiuui— iuu ncigiu- 

</RectangleGeometry. Rect> 
</Rectang!eGecmetry> 

<PathGeometry> 
<PathGeometry.Figures> 
<PathFigureCollection> 
<PathFigure> 
<PathFigure.Segments> 
<PathSegmentCoiiection> 
<StartSegment Point="400,1007> 

<BezierSegrr.ent Pointl ="400, 100" Point2= M 400,200" Poir.t3="200,3007> 
<BezierSegment Pointl ="400,300" Point2= ,, 400 I 100 ,, Point3= n 200,507> 
^BezierSegment Pointl ="0,100" Point2="Q,200" Pclnt3="200,3007> 
<BezierSegment Pointl ="o!300" Point2="o!l00" Point3="20o!507> 
</PathSegmentCollection> 
</PathFigure.Segments> 
</PathFigure> 
</PathFigureCollection> 
</PathGeometry.Figures> 
</PathGeometry> 

^ ir* _ ^ ./"*-%n 
nvjcuiiicu yuunc^uui 

"^/Path.Data^ 
</Path> 

</Canvas> 

in the previous exampie, the PathFigure object, one of the shapes drawn inside the Path eiemeni, 
contains a StartSegment but no CloseSegment; if a CloseSegment were added to the figure, a line would 
be drawn from the last segment in the co! lection back to the starting point of the figure. 



LineSegment Class 

Definition: Represents ajine between two points. Unlike LineGeometry objects, LineSegment must be 
contained within a PathFigure. 



Method 



CloneCore 



CloneCore 

CloneDownToUnchangeable 



Description 

Returns a modifiable shallow or deep clone of the current object. 
This abstract method must be implemented by classes that 
derive from Changeable. Inherited from Changeable. 

Implementation of Animatable.CloneCore. 

Returns an immutable copy of the specified object. Inherited 
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Copy 

Copy 
Copy 

DisabieCore 

EmbeddedAnimationCollectionReader 

EmbeddedAnimationCollectionWriter 

EmbeddedChangeableReader 

EmbeddedChangeableWriter 

EnableCore 

Equals 



GetCurrentValue 
GetCurrentValue 
GetCurrentValue 

GetHashCode 

GetType 
LineSegment 

MakeUnchangeable 

MakeUnchangeabieCore 
MemberwiseCione 

ModifyHandlerlfChanqeable 

OnChanged 

PropagateEventHandler 

ReadPreamble 



from Changeable. 

Creates a copy of this Path-Segment. Inherited from 
PathSegment. 

Rst'jm c 23 mnHtfiahlo rnnu of tho ourront nhiart Tho rnn\/'c 

IsChangeable property is true and its StatusOfNextUse is 
Unchangeable. Inherited from Changeable. 

Creates a copy of this LineSegment. 

Inherited from PathSegment. 

Maybe this should be internal?? Inherited from Animatable. 
Inherited from Animatable. 
Inherited from Animatable. 
Inherited from Animatable. 
Inherited from PathSegment. 

Determines whether two Object instances are equal. Inherited 



Allows an Object to attempt to free resources and perform other 
cleanup operations before the Object is reclaimed by garbage 
collection. Inherited from Object. 

Returns a non-animated version of this GradieniSiop that 
represents its current state. Inherited from PathSegment. 

Returns a non-animated version of this Animatabie that 
represents its current state. Inherited from Animatable. 

Returns a non-animated version of this LineSegment that 
represents its current state. 

Serves as a hash function for a particular type, suitable for use in 
hashing algorithms and data structures like a hash 
tabie. inherited from Object. 

Gets the Type of the current instance. Inherited from Object. 

Set to true if the line is stroked when a Pen is used to render the 
segment. 

Makes an object immutable; after this method is called on a 
Changeable, its IsChangeable property is false. Inherited from 
Changeable. 

Implementation of MakeUnchanqeableCore. Inherited from 
PathSegment. 

Creates a shallow copy of the current Object. Inherited from 
Object. 

Adds or removes a Changed event handler to or from the 
specified Changeable object, if the object is currently modifiable. 
If the specified object is not modifiable — if its IsChangeable 
property is false — this method has no effect. Inherited from 
Changeable. 

Called when the current object is modified. Classes that derive 
from Changed should call this method after they have been 
modified. Inherited from Changeable. 

Implementation of PropagateEventHandler. 

Ensures that simple (non-Changeable) members are being 
accessed from a valid Ul context. This method should be called 
before any simple members are accessed. Inherited from 
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Keferencetquais 

SetDefaultParentTimeline 

SetDefaultParentTimelineCore 
ToString 

ValidateObjectState 
WritePostscript 

WritePreamble 

Property 

AllowChangeableReferenceOverride 
CanMakeUnchangeable 

DefaultParentTimeline 

HasAnimations 
IsAnimating 

IsChangeable 

IsOverridingBaseValue 

Point 

PointAnimations 
StatusOfNextUse 
UlContext 



Changeable. 

Determines whether the specified Object instances are the same 
instance. Inherited from Object. 

This will change the time parent for animations on any of the 
properties of this Changeable which are inheriting their time 
parent. Inherited from Animatable. 

Inherited from PathSegment. 

Returns a String that represents the current Object, inherited 
from Object. 

Verifies thai trie Current object has a vaiid State, if Uie object is in 
an invalid state, this method throws an exception. Inherited from 

Wl I Gil IVjCOUIC. 

Causes the current object to validate itself and then invokes the 
OnChanged me mod. Inherited from Changeable. 

Ensures that simple (non-Changeable) members are being 
accessed from a vaiid user interface (ui) context. This method 
should be called before any simple members are set. Inherited 

ii ui 1 1 unallocable. 

Description 

Used in conjunction with the ChangeableUsageOverride type sent in 
as a parameter to ChangeableHelper.UseChangeable, to help 
determine when a Changeable being put into "use" should be 
promoted to :! ChangeabieReference !! . inherited from Changeable. 

True if this Changeable can be made unchangeable. Inherited from 
Changeable. 

The current parent Timeline associated with this Animatable. This 
will be the Timeline set to the ParentTimeline property of this 
Animatable if one has been set and if not, the Timeline last passed 
into the SetDefauitParentTimeiine method, inherited from 
Animatable. 

Gets a Booiean that indicates whether the segment has animations. 

Gets a Boolean that indicates whether the object is currently 
modifiable. Inherited from Changeable. 

Gets or sets a Boolean that determines whether the segment is 
stroked. Inherited from PathSegment. 

Gets or sets the end point of the line segment. 

Gets or sets a collection of PointModifier objects that animate the 
line segment's end point. 

Gets or sets a UseStatus enumeration that specifies how the 
Changeable object behaves when it is "used." A Changeable object 
is considered used in the following situations: the object is set into a 
Property System property, the object is used as a sub-object in a 
complex Changeable object, or the object is used in a 
DrawingContext command. Inherited from Changeable. 

Gets the UlContext of the current object. The UlContext is used for 
maintaining thread safety. Inherited from Changeable. 
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Use a PathFigure object to store LineSegment objects and other segments. 

The LineSegment class does not contain a property for the line's start point. The line's starting point is the 
current point of the PathFigure object to which the iine is added. 

This exarnple demonstrates how to draw shapes using the Geometry, PathFigure, and P athSegment 
classes. In this example, several shapes are drawn using Geometry objects and are displayed using a 

path ojomont 

There is a Geometry class for each basic geometric shape: LineGeometry, EllipseGeometry ; and 
RectangleGeometry. Complex shapes, such as polygons and shapes with curved segments, may be 
created using a PathGeometry. 

In the following example, a LineGeometry, EllipseGeometry, and a RectangleGeometry object are used to 
create a line, an ellipse, and a rectangle. 
// C# 

MSAvalon. Windows. Media. LineGeometry myLineGeometry = 

new LineGecmetry(new Pcint(50, 50), new Point(300, 50)); 

MS Avalon. Windows. Media. EHipseGeometry rrr/EHipseGeometry = 
new EllipseGeometry(new Point(440, 100), 40, 75); 

MSAvalon. Windows. Media. RectangleGeometry myRectangleGeometry = 
new RectangleGeometry(new Rect(new Point(400, 225), new Size(100, 50))); 

•VB.NET 

Dim myLineGeometry As new MSAvalon.Windows.Media.LineGeometry( _ 
new MSAvaion. Windows. Point(50, 50), new MSAvaion. Windows. Point(300, 50)) 

Dim myEllipseGeometry As new MSAvalon.Windows.Media.EllipseGeometry( _ 
new MSAvalon.Windows.Point(440 v 100), 40, 75) 

Dim myRectangleGeometry As new MSAvaion. Windows.Media.RectangleGeometry( _ 
new MSAvaion .Windows. Rect(new MSAvaion. Windows. Point{400 225) 
new MSAvalon.Windows.Size(1 00,50))) 



PathGeometry objects can be used to create complex shapes, such as arcs and curves. PathGeometry 
objects are comprised of one or more PathFigure objects; each PathFigure represents a different "figure" 
or shape, tach PathFigure is itseif comprised of one or more PathSegmeni objects, each representing a 
connected portion of the figure or shape. Segment types include the following: LineSegment, 
SezierSegment, and ArcSegment. 

!n the following code, a PathGeometry and a PathFigure are created, and several segments are added to 
the PathFigure to form a shape. There are several ways to add segments to a PathFigure; you can use 
the PathFigure object's "draw segment" commands to automatically create new segments and add them 
to the figure, or you can explicitly create segments and add them manually using the PathFigure object's 
Segments property or AddSegment method. This example shows both ways of adding segments to a 
figure. 

The first segment of a PathFigure must be a StartSegment. The StariSegment may be added by creating 
a new StartSegment and adding it to the PathFigure, or it can be added using the PathFigure object's 
StartAt method. The following code demonstrates adding a StartSegment using the StartAt method. The 
start point is set to (200,50). 

//C# 

MSAvaion. Windows. Media. PathGeometry myPathGeometry = new PathGeometry(); 
MSAvaion.vVindows.Media.PathFigure myPathFigure = new PathFigure(); 
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// PathFigure objects must have a defined start point before 
// other segments can be added. 
myPaihFigure.StariAt(new Poini(200,50)); 

i \ /o fc 1 1 — r 

v o .me i 

Dim myPathGeometry As new MSAvalon. Windows. Media. PathGeometry() 
Dim myPathFigure As new MSAvalon. Windows. Media. PathFigureQ 

' PathFigure objects must have a defined start point before 
' other segments can be added. 

myPathFigure.StartAt(new MSAvalon. Windows. Point(200,50)) 

In the following code, the BezierTo method is used to create three Etezier curves. A fourth curve is 
created by explicitly creating a BezierSegmen^and adding it to myPathFigure using the AddSegment 
method. After the segments are added to the PathFigure (myPathFigure), the PathFigure is added to the 
PathGeometry. 

II C# 

myPathFigure. BezierTo( 
new Point(400, 100), new Point(400, 200), new Point(200, 300)); 

iiiyrauinyuicuc^ici iu( 

new Point(400, 300), new Point(400, 100), new Point(200, 50)); 

myPathFigure. BezierTo( 
new Point(0, 100), new Point(0, 200), new Point(200,300)); 

MSAvalon. Windows. Media. BezierSegment myBezierSegment = 
new BezierSegment(new Point(0, 300), new Point(0, 100), new Point(200, 50), true); 

myPathFigure.AddSegment(myBezierSegment); 

myPathGeometry.Figures.Add(myPathFigure); 



my PathFigure. BezierTo(new MSAvalon. Windows. Point(400, 100), _ 
new MSA valcn. Windows. Point(400, 200), new MSAvalon. Windows. Point(200 300)) 

myPathFigure.BezierTo(new MSAvalon.Windows.Point(400 : 300V _ 
new MS Avalon. Windows. Point(400, 100), new MSAvalon. Windows. Point(200, 50)) 

myPathFigure.BezierTo(new MSAvalon. Windows. Point(0, 100), _ 
new MSAvalon.Windows.Point(0, 200), new MSAvalon.Windows.Point(200,300)) 

Dim myBezierSegment As new BezierSegment( _ 
new MSAvalon. Windows. Point(0, 300), new MSAvalon. Windows. Point(0, 100), _ 
new MSAvaion. Windows. Koini(200, 50), true) 

myrathrigure.AuuSegmeni(myBezierSegment) 

■ .Ann fho PathFigure to the PathGeometry 
myPathGeometry. Figures. Add(my Path Figure) 

In the final code example, the geometries are added to a GeometryCollection, and the 
GeometryCollection is used to set the Path element's Data property. Had there been only one geometry, 
it couid have been used to set the Data property directiy, without the GeometryCoiieciion. 
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//c# 

GeometryCollection myGeometryCollection = new GeometryCoilectionQ; 

myGeometryCoiiection.Acid(myLineGeometry); 

myGeometryCollection.Add(myEllipseGeometry); 

m y Geometry CoS Section . Add (my Rectang leGeo rnetry ) ; 

myGeometryCollection.Add(myPathGeometry); 

Path myPath = new Path(); 
myPath.Data = myGeometryCollection; 

// Set the outline and the fill of the Path element. 

myPath.Stroke = Brushes.Blue; 

myPath.StrokeThickness = new Length(5); 

SolidColorBrush solidFill = new SolidColorBrush(); 

rny Pain. Fill = new RauialGradieritBrush(Coiors. Grange, Colors. Red); 

// ahh fho Psth element tc a Canvas 
myCanvas.Children.Add(myPath); 

•VB.NET 

Dim myGeometryCollection As new MSAvalon.Windows.Media.GeometryCollectionQ 

myGeometryCoiieciion.Add(myLineGeometry) 

myGeometryCollection.Add(myEllipseGeometry) 

rnyGeo rn etryCo » lection . Add(rny Recta ng leGeorn etry ) 

myGeometryCollection.Add(myPathGeometry) 

Dim myPath As new Path() 
myPath.Data = myGeometryCollection 

' Set the outline and the fill of the Path element. 
myPath.Stroke = MSAvalon.Windows. Media. Brushes. Blue 
myPath.StrokeThickness = new MSAvaion. Windows. Length(5) 
Dim solidFill As new MSAvalon.Windows.Media.SolidColorBrush() 
myPaih.Fiil = new RauialGradientBrush(mSAvalon. Windows. Media. Colors.Grange, _ 
MSAvalon.Windows.Media.Colors.Red) 

' Add the Path element to a Canvas. 
myCanvas.Children.Add(myPath) 

Geometry objects may also be rendered using the DrawingContext, which supplies a DrawGeometry 
method that may be used to render Geometry objects. Geometry objects may also be used for clipping 
and hit-testing. 



MatrixTransform Class 

Definition: Creates an arbitrary affine matrix transformation used to manipulate objects or coordinate 
systems in a two-dimensionai piane. 



Method 



CloneCore 



CloneCore 



^l««»^r>^...«T«.l I. U ~ Ll„ 

oiuiicl/uvvi i i uunu iai lycauic 



Description 

Returns a modifiable shallow or deep clone of the current object. 
This abstract method must be implemented by classes that 
derive from Changeable. Inherited from Changeable. 

Implementation of Animatable.CloneCore. 

Returns an immutable copy of the specified object. Inherited 
from Changeable. 
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Copy 
Copy 
Copy 

CreateMatrix 

CreateRotation 

CreateScale 

CreateSkew 

CreateTranslation 

DisableCore 

Dispose 

EmbeddedAnimationCollectionReader 

EmbeddedAnimationCollectionWriter 

EmbeddedChangeableReader 



IhangeableWriter 
EnableCore 

Equals 

Finalize 

GetCurrentValue 

GetCurrentValue 

GetCurrentValue 
GetHasAnimations 

GetHashCode 

GetlsAnimating 

GetisGverriding8aseVaiue 

GetType 

MakeUnchangeable 

Ma ke Unchangeable ore 

MatrixTransform 
MemberwiseClone 



Creates a copy of this Transform. Inherited from Transform. 
Returns a modifiable copy of the current object. The copy's 
IsChangeable property is true and its StatusOfNextUse'is 
Unchangeable. Inherited from Changeable. 

Creates a copy of this MatrixTransform. 

Creates an arbitrary affine transformation matrix used for 

transformations in a two-dimensional plane. Inherited from 

Transform. 

Creates a transformation used for rotation in a two-dimensional 
plane. Inherited from Transform. 

Creates a transformation used for scaling in a two-dimensional 

piCMIt*. Mil ICI ILOV^t liUIII I I Ul IOIUI 111. 

Creates a transformation used for skewing in a two-dimensional 

pis n 6. In hen ted from Transform. 

Creates a transformation used for translating in the x- and y- 
directions in a Lwo-dimensionai piane. inherited from Transform. 
Inherited from Transform. 

Dispose resources associated with transform. Inherited from 
Transform. 

Maybe this should be internal?? Inherited from Animatable. 
Inherited from Animatable. 
Inherited from Animatable. 
inherited from Animatable. 
Inherited from Transform. 

Determines whether two Object instances are equal. Inherited 
from Object. 

Inherited from Transform. 

Creates a non-animated copy of this Transform with all of its 
base values set to the current animated values. Inherited from 
Transform. 

Returns a non-animated version of this Animatable that 
represents its current state. Inherited from Animatable. 

Returns a non-animated version of this MatrixTransform that 
represents its current state. 

Inherited from Transform. 

Serves as a hash function for a particular type, suitable for use in 
hashing algorithms and data structures like a hash 
table. Inherited from Object 

Inherited from Transform. 

In heriied from Transform. 

Gets the Type of the current instance. Inherited from Object. 
Makes an object immutable; after this method is called on a 
Changeable, its IsChangeable property is false. Inherited from 
Changeable. 

Implementation of MakeUnchangeableCore. Inherited from 
Transform. 

Initializes a new instance of the MatrixTransform class. 
Creates a shallow copy of the current Object. Inherited from 
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ModifyHandlerlfChangeable 
OnChanged 

PropagateEventHandler 
ReadPreamble 

ReferenceEquals 

SetDefaultParentTimeline 

SetDefaultParentTimeline 
SetDefaultParentTimeiineCore 

ToString 

ValidateObjectState 
WritePostscript 

WritePreamble 



Object. 

Adds or removes a Changed event handler to or from the 
specified Changeable object, if the object is currently modifiable. 
If the specified object is not modifiable— if its IsChangeable 
property is false— this method has no effect. Inherited from 
Changeable. 

Called when the current object is modified. Classes that derive 
from Changed should call this method after they have been 
modified. Inherited from Changeable. 

Ensures that simple (non-Changeable) members are being 
accessed from a valid Ul context. This method should be called 
before any simple members are accessed. Inherited from 
Changeable. 

Determines whether the specified Object instances are the same 
instance. Inherited from Object. 

This will change the time parent for animations on any of the 
properties of this Changeable which are inheriting their time 
parent. Inherited from Animatable. 

Inherited from Transform. 

Inherited from Transform. 

Not implemented. Use Object. ToString instead. Inherited from 
Transform. 

Verifies that the current object has a valid state. If the object is in 
an invalid state, this method throws an exception. Inherited from 
Changeable. 

Causes the current object to validate itself and then invokes the 
OnChanged method. Inherited from Changeable. 
Ensures that simple (non-Changeable) members are being 
accessed from a valid user interface (Ul) context. This method 
should be called before any simple members are set. Inherited 
from Changeable. 



Property Description 

Used in conjunction with the ChangeableUsageOverride type sent in 

AllowChangeableReferenceOverride as a P arameter to ChangeableHelper.UseChangeable, to help 

determine when a Changeable being put into "use" should be 
promoted to "ChangeableReference". Inherited from Changeable. 

True if this Changeable can be made unchangeable. Inherited from 
Changeable. 

The current parent Timeline associated with this Animatable. This 
will be the Timeline set to the ParentTimeline property of this 
Animatable if one has been set and if not, the Timeline last passed 
into the SetDefaultParentTimeline method, inherited from 
Animatable. 



CanMakeUnchangeable 



DefaultParentTimeline 



HasAnimations 

Identity 

IsAnimating 

IsChangeable 



Gets a Boolean that indicates whether the transformation has 
animations- 
Identity transformation. Inherited from Transform. 
Returns true if the transformation contains active animations. 
Gets a Boolean that indicates whether the object is currently 
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modifiable. Inherited from Changeable. 

Gets or sets the Matrix structure that defines this transformation. 
Gets or sets a UseStatus enumeration that specifies how the 
Changeable object behaves when it is "used." A Changeable object 
is considered used in the following situations: the object is set into a 
Property System property, the object is used as a sub-object in a 
complex Changeable object, or the object is used in a 
DrawingContext command. Inherited from Changeable. 

Gets the UlContext of the current object. The UlContext is used for 
maintaining thread safety. Inherited from Changeable. 

Gets the current matrix transformation as a Matrix object. 

Use the MatrixTransform class to create custom transformations not provided by the RotateTransform, 
SkewTransform, ScaleTransform, or TranslateTransform classes. 

A 3x3 matrix is used for transformations in a two-dimensional x-y plane. Affine transformation matrices 
can be multiplied to form any number of linear transformations, such as rotation and skew (shear), 
followed by translation. An affine transformation matrix has its final column equal to (0, 0, 1), so only the 
members in the first two columns need to be specified. 

An "Avalon" Matrix has the following structure: 

M11 M12 0 
M21 M22 0 
OffsetX OffsetY 1 

The members in the last row, OffsetX and OffsetY, represent translation values. 

In methods and properties the transformation matrix is usually specified as a vector with only six 

members, as follows: 

(M11, M12, M21, M22, OffsetX, OffsetY) 



IsOverridingBaseValue 
Matrix 

StatusOfNextUse 

UlContext 
Value 



MediaData Class 

Definition: MediaData. Use to playback AudioA/ideo content. 



Method 



Beginln 
CloneCore 



Description 

Schedules an interactive begin time. 
Clones this MediaData. 



CloneDownToUnchangeable 



Copy 



Disable 



Returns an immutable copy of the specified object. Inherited from 
Changeable. 

Returns a modifiable copy of the current object. The copy's IsChangeable 
property is true and its StatusOfNextUse is Unchangeable. Inherited from 
Changeable. 

Disables this timeline, after which the timeline can no longer become 
active. The timeline can be re-enabled with a call to Enable. 
Dispose the object. 

Accesses the specified Changeable data member, processes it, and 
returns a reference to the member. This reference should then be 

EmbeddedChangeableReader reassigned to the original member variable. Classes that derive from 

Changeable call this method on data members before they can be 

retrieved through property calls. Inherited from Changeable. 



Dispose 
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EmbeddedChangeableWriter 

Enable 

Endln 

Equals 

Finalize 

GetHashCode 

GetType 

MakeUnchangeable 

MakeUnchangeableCore 

MediaData 

MemberwiseClone 

ModifyHandlerlfChangeable 

OnChanged 

Pause 
Play 

PropagateEventHandier 
ReadPreamble 

ReferenceEquals 

Resume 

Seek 

ToString 

ValidateObjectState 
WritePostscript 

WritePreamble 



Processes a modified Changeable data member and returns a reference 
to the processed object. Inherited from Changeable. 

Enables this timeline, parenting it to the timeline specified by the 
ParentTimeline property. This allows the timeline to become active. This 
method throws an exception if the ParentTimeline property is null. 
Schedules an interactive end time. 

Determines whether two Object instances are equal. Inherited from 
Object. 

Finalizes the MediaData. 

Serves as a hash function for a particular type, suitable for use in hashing 
algorithms and data structures like a hash table. Inherited from Object. 
Gets the Type of the current instance. Inherited from Object. 

Makes an object immutable; after this method is called on a Changeable, 
its IsChangeable property is false. Inherited from Changeable. 
Implementation of MakeUnchangeableCore. 
Creates a new MediaData. 

Creates a shallow copy of the current Object. Inherited from Object. 
Adds or removes a Changed event handler to or from the specified 
Changeable object, if the object is currently modifiable. If the specified 
object is not modifiable— if its IsChangeable property is false— this method 
has no effect. Inherited from Changeable. 

Called when the current object is modified. Classes that derive from 
Changed should call this method after they have been modified. Inherited 
from Changeable. 

Pauses this media. 

Begins playback of media. 

Propogates event handier to the timeline 

Ensures that simple (non-Changeable) members are being accessed from 
a valid user interface (Ul) context. This method should be called before 
any simple members are accessed. Inherited from Changeable. 

Determines whether the specified Object instances are the same 
instance. Inherited from Object. 

Resumes this media. 

Moves the timeline for this media. 

Persist MediaData in a string 

Verifies that the current object has a valid state. If the object is in an 
invalid state, this method throws an exception. Inherited from Changeable. 
Causes the current object to validate itself and then invokes the 
OnChanged method. Inherited from Changeable. 

Ensures that simple (non-Changeable) members are being accessed from 
a valid Ul context. This method should be called before any simple 
members are set. Inherited from Changeable. 



Property Description 

Acceleration Accesses the Acceleration SMIL attribute. 

Used in conjunction with the ChangeableUsageOverride type sent in 

AllowChangeableReferenceOverride * s a P arameter to ChangeableHelper.UseChangeable, to help 

determine when a Changeable being put into "use" should be 
promoted to "ChangeableReference". Inherited from Changeable. 
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AutoReverse 
Begin 

CanMakeUnchangeable 

CurrentRepeat 

CurrentTime 

Deceleration 

Duration 

End 

EndSync 
Fill 

FillDefault 

HasAudio 

HasChanged 

HasVideo 

Height 

IsChangeable 

IsChanging 
IsEnabled 

IsForwardProgressing 

IsOverriding Base Value 

IsPaused 

IsReversed 

MediaDuration 

Mute 

ParentTimeline 

Progress 

RepeatCount 

RepeatDuration 

Restart 

RestartDefault 

Speed 

State 



StatusOfNextUse 



UlContext 

Volume 
Width 



Accesses the AutoReverse SMIL attribute. 
Accesses the Begin SMIL attribute. 

True if this Changeable can be made unchangeable. Inherited from 
Changeable. 

The current repetition iteration. 
The current time local to this media. 
Accesses the Deceleration SMIL attribute. 
Accesses the Duration SMIL attribute. 
Accesses the End SMIL attribute. 
Accesses the EndSync SMIL attribute. 
Accesses the Fill SMIL attribute. 
Accesses the FillDefault SMIL attribute. 
True if the media has audio output. 
True if the media has changed since the last tick. 
True if the media has a visual output. 
Get the video Height in pixels 

Gets a Boolean that indicates whether the object is currently 
modifiable. Inherited from Changeable. 

True if the media is active, false otherwise. 

True if the media is enabled, false otherwise. 

True if the media is moving from past to future. 

True if the media is either changing or in a fill state, false otherwise. 

True if this media is paused. 

True if this media is in a reverse period. 

Returns the native media duration. 

Accesses the mute state of media playback. 

Accesses the ParentTimeline attribute. 

The current progress of the media, from 0 to 1 . 

Accesses the RepeatCount SMIL attribute. 

Accesses the RepeatDuration SMIL attribute. 

Accesses the Restart SMIL attribute. 

Accesses the RestartDefault SMIL attribute. 

Accesses the Speed SMIL attribute. 

Returns the current state of the media. 

Gets or sets a UseStatus enumeration that specifies how the 
Changeable object behaves when it is "used." A Changeable object 
is considered used in the following situations: the object is set into a 
Property System property, the object is used as a sub-object in a 
complex Changeable object, or the object is used in a 
DrawingContext command. Inherited from Changeable. 

Gets the UlContext of the current object. The UlContext is used for 
maintaining thread safety. Inherited from Changeable. 

Accesses the volume of media playback. 

Get the video Width in pixels 
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MediaSystem Class 

Definition: The MediaSystem class controls the media layer. 



Method 

Equals 
Finalize 

GetHashCode 

GetType 

MediaSystem 

MemberwiseClone 

ReferenceEquals 

Shutdown 
StartFastAnimation 

Startup 

StopFastAnimation 
ToString 



Description 

Determines whether two Object instances are equal. Inherited from Object. 
Allows an Object to attempt to free resources and perform other cleanup 
operations before the Object is reclaimed by garbage collection. Inherited from 
Object. 

Serves as a hash function for a particular type, suitable for use in hashing 
algorithms and data structures like a hash table. Inherited from Object. 
Gets the Type of the current instance. Inherited from Object. 
Initializes a new instance of the MediaSystem class. 
Creates a shallow copy of the current Object. Inherited from Object. 

Determines whether the specified Object instances are the same 
instance. Inherited from Object. 

This deinitializes the MediaSystem and frees any resources that it maintains. 

Calling this function causes the the MediaSystem to render as fast as possible. 

This function initializes the MediaSystem. It must be called before any functions in 
the Media namespace can be used. 

This function will cease attempting to render as fast as possible. Rendering will 
still occur as normal. 

Returns a String that represents the current Object. Inherited from Object. 



Property 

CompositionDevice 
RenderDevice 



Description 

Returns a handle to the global composition device. 
Returns a handle to the global render device. 



NineGridBrush Class 

Definition: Fills an entire area with an image. Portions of the image are stretched to fit within defined 
margins. 



Method 

CloneCore 
CloneCore 

CloneDownToUnchangeable 
Copy 

Copy 
Copy 

DeserializeFrom 
DisableCore 



Description 

Implementation of Animatable.CloneCore. 

Returns a modifiable shallow or deep clone of the current object. 
This abstract method must be implemented by classes that 
derive from Changeable. Inherited from Changeable. 

Returns an immutable copy of the specified object. Inherited 
from Changeable. 

Returns a modifiable copy of the brush. The copy's 
IsChangeable property is true and its StatusOfNextUse is 
Unchangeable. Inherited from Brush. 

Returns a modifiable copy of the current object. The copy's 
IsChangeable property is true and its StatusOfNextUse is 
Unchangeable. Inherited from Changeable. 

Returns a new Brush initialized from the binary representation 
being read by the passed BinaryReader. Inherited from Brush. 
Inherited from Brush. 
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EmbeddedAnimationCollectionReader 
EmbeddedAnimationCollectionWriter 
EmbeddedChangeableReader 
Ei i ibeudedChang eabieVVi iter 
EnableCore 

Equals 

Finalize 



GetCurrentValue 

GetCurrentValue 
GetHasAnimations 

GetHashCode 

GetlsAnimating 

GetlsOverridingBaseValue 

GetType 

MakeUnchangeable 

MakeUnchangeableCore 
MemberwiseClone 

ModifyHandlerlfChangeable 

NineGridBrush 
OnChanged 

PropagateEventHandler 
ReadPreamble 

ReferenceEquals 
SerializeOn 

SetDefaultParentTimeline 
SetDefaultParentTimeline 



Maybe this should be internal?? Inherited from Animatable. 
Inherited from Animatable. 
Inherited from Animatable. 
inherited from Animatable. 
Inherited from Brush. 

Determines whether two Object instances are equal. Inherited 
from Object. 

Inherited from Brush. 

Returns the current value of the brush. The returned brush has 
the same value as the current object, but doesn't vary over time; 
that is, the returned brush is a snapshot of the current object at 
the point in time at which this method was called. Inherited from 
Brush. 

Returns a non-animated version of this Animatable that 
represents its current state. Inherited from Animatable. 
Inherited from Brush. 

Serves as a hash function for a particular type, suitable for use in 
hashing algorithms and data structures like a hash 
table. Inherited from Object. 

Inherited from Brush. 

Inherited from Brush. 

Gets the Type of the current instance. Inherited from Object. 
Makes an object immutable; after this method is called on a 
Changeable, its IsChangeable property is false. Inherited from 
Changeable. 

Creates a shallow copy of the current Object. Inherited from 
Object. 

Adds or removes a Changed event handler to or from the 
specified Changeable object, if the object is currently modifiable. 
If the specified object is not modifiable — if its IsChangeable 
property is false — this method has no effect. Inherited from 
Changeable. 

Called when the current object is modified. Classes that derive 
from Changed should call this method after they have been 
modified. Inherited from Changeable. 

Ensures that simple (non-Changeable) members are being 
accessed from a valid Ul context. This method should be called 
before any simple members are accessed. Inherited from 
Changeable. 

Determines whether the specified Object instances are the same 
instance. Inherited from Object. 

Serialize this object using the passed writer Inherited from Brush. 
Inherited from Brush. 

This will change the time parent for animations on any of the 
properties of this Changeable which are inheriting their time 
parent. Inherited from Animatable. 
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SetDefaultParentTimelineCore 
ToString 

ValidateObjectState 
WritePostscript 

WritePreamble 



Inherited from Brush. 

Returns a String that represents the current Object. Inherited 
from Object. 

Verifies that the current object has a valid state. If the object is in 
an invalid state, this method throws an exception. Inherited from 
Changeable. 

Causes the current object to validate itself and then invokes the 
OnChanged method. Inherited from Changeable. 

Ensures that simple (non-Changeable) members are being 
accessed from a valid user interface (Ul) context. This method 
should be called before any simple members are set. Inherited 
from Changeable. 



Property 

AllowChangeableReferenceOverride 

BottomBorder 
CanMakeUnchangeable 

DefaultParentTimeline 

GlyphlmageSource 

HasAnimations 

ImageSource 
IsAnimating 

IsChangeable 

IsOverridingBaseValue 

LeftBorder 

Opacity 

OpacityAnimations 
RightBorder 

StatusOfNextUse 

TopBorder 



Description 

Used in conjunction with the ChangeableUsageOverride type sent in 
as a parameter to ChangeableHelper.UseChangeable, to help 
determine when a Changeable being put into "use" should be 
promoted to "ChangeableReference". Inherited from Changeable. 

BottomBorder - This accessor allows read only access to the 
BottomBorder property 

True if this Changeable can be made unchangeable. Inherited from 
Changeable. 

The current parent Timeline associated with this Animatable. This 
will be the Timeline set to the ParentTimeline property of this 
Animatable if one has been set and if not, the Timeline last passed 
into the SetDefaultParentTimeline method. Inherited from 
Animatable. 

Gets a Boolean that indicates whether the brush has 
animations. Inherited from Brush. 

Inherited from Brush. 

Gets a Boolean that indicates whether the object is currently 
modifiable. Inherited from Changeable. 
Inherited from Brush. 

LeftBorder - This accessor allows read only access to the 
LeftBorder property 

Gets or sets the degree of opacity of a Brush. Inherited from Brush. 

Gets or sets the animations associated with the Opacity of the 
brush. Inherited from Brush. 

RightBorder - This accessor allows read only access to the 
RightBorder property 

Gets or sets a UseStatus enumeration that specifies how the 
Changeable object behaves when it is "used." A Changeable object 
is considered used in the following situations: the object is set into a 
Property System property, the object is used as a sub-object in a 
complex Changeable object, or the object is used in a 
DrawingContext command. Inherited from Changeable. 

TopBorder - This accessor allows read only access to the 
TopBorder property 
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Transform 



UlContext 



Gets or sets a transformation that is applied to the brush. This 
transformation is applied after all other mapping and positioning 
have been processed. Inherited from Brush. 

Gets the UlContext of the current object The UlContext is used for 
maintaining thread safety. Inherited from Changeable. 



A NineGridBrush is very similar to an image brush in that it fills an area with a bitmap image. With a 
NineGridBrush, however, the image is divided into nine regions or grids by four borders. For more 
information, see the NineGridBrush page. 

The following image is a typical bitmap that can be divided into nine grids. 

The following image shows the same bitmap with nine grid borders highlighted with red lines. 

The advantage of defining separate regions of the bitmap is that the image can be stretched without 
distorting the details around the edges or corners. If the image is stretched horizontally, only the center 
grid of each row is transformed, leaving the right and left edge unchanged. Similarly, if the image is 
stretched vertically, only the center grid of each column is transformed, leaving the top and bottom edges 
unchanged. The following image shows the previous NineGridBrush after it has been stretched in both 
directions. 

The simplest way to fill a control with a NineGridBrush in "Longhorn" markup language (code-named 
"XAML") is to use the NineGrid keyword, followed by the file containing the image, and the offsets 
between the edges of the image and the borders. Offsets are always specified in the same order: left 
margin, right margin, top margin, bottom margin. The following image shows a set of borders with the 
margins labeled A, B, C, and D. 



The syntax to create these borders for an image called myimage.png would look like this: 
NineGrid myimage.png A B C D 

PathFigure Class 

Definition: Represents a sub-section of a geometry, a single connected series of two-dimensional 
geometric segments. 



Method 



Description 



AddSegment 



Adds the specified segment to the figure. 

Creates an ArcSegment, an elliptical arc, from the current point to 
the specified end point and adds it to the path. The path's current 
point is set to the end point of the arc. 

Creates a BezierSegment, a cubic Bezier curve, and then adds it 
to the path. The BezierSegment is created from the current point 
to the specified end point using the two specified control points. 
The current point of the path is set to the end point of the curve. 
Returns a modifiable shallow or deep clone of the current object. 
This abstract method must be implemented by classes that 
derive from Changeable. Inherited from Changeable. 
Implementation of Animatable.CloneCore. 



ArcTo 



BezierTo 



CloneCore 



CloneCore 



CloneDownToUnchangeable 



Returns an immutable copy of the specified object. Inherited from 
Changeable. 



Close 



Copy 



Returns a modifiable copy of the current object. The copy's 
IsChangeable property is true and its StatusOfNextUse is 
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Unchangeable. Inherited from Changeable. 
Copy Creates a copy of this PathFigure. 

DisableCore 

EmbeddedAnirnationCollectionReader Maybe this should be internal?? Inherited from Animatable. 
EmbeddedAnimationCollectionWriter Inherited from Animatable. 
EmbeddedChangeableReader Inherited from Animatable. 

EmbeddedChangeableWriter Inherited from Animatable. 

EnableCore 



Equals 
Finalize 

GetCurrentValue 

GetCurrentValue 
GetFlattenedPathFigure 

GetHashCode 

GetType 

lAddChild.AddChild 
IAddChild.AddText 

LineTo 

MakeUnchangeable 

MakeUnchangeableCore 
MemberwiseClone 

ModifyHandlerlfChangeabie 

OnChanged 

PathFigure 

PolyBezierTo 

PolyLineTo 

PolyQuadraticBezierTo 



Determines whether two Object instances are equal. Inherited 
from Object. 

Allows an Object to attempt to free resources and perform other 
cleanup operations before the Object is reclaimed by garbage 
collection. Inherited from Object. 

Returns a non-animated version of this PathFigure that 
represents its current state. 

Returns a non-animated version of this Animatable that 
represents its current state. Inherited from Animatable. 

Serves as a hash function for a particular type, suitable for use in 
hashing algorithms and data structures like a hash 
table. Inherited from Object. 

Gets the Type of the current instance. Inherited from Object. 



Creates a line from the current point (the end point of the last 
segment defined in the current figure's Segments property) to the 
specified point. 

Makes an object immutable; after this method is called on a 
Changeable, its IsChangeable property is false. Inherited from 
Changeable. 

Creates a shallow copy of the current Object. Inherited from 
Object. 

Adds or removes a Changed event handler to or from the 
specified Changeable object, if the object is currently modifiable. 
If the specified object is not modifiable— if its IsChangeable 
property is false— this method has no effect. Inherited from 
Changeable. 

Called when the current object is modified. Classes that derive 
from Changed should call this method after they have been 
modified. Inherited from Changeable. 

Creates a series of cubic Bezier curves and adds them to the 
path. The path's current point is set to the destination point of the 
last curve. 

Creates a series of lines and adds them to the path. The path's 
current point is set to the destination point of the last line. 
Creates a series of quadratic Bezier curves and adds them to the 
path. The path's current point is set to the destination point of the 
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PropagateEventHandler 
QuadraticBezierTo 

ReadPreamble 

ReferenceEquals 

SetDefaultParentTimeline 

SetDefaultParentTimelineCore 
StartAt 

StrokeNewSegments 
ToString 

ValidateObjectState 
WritePostscript 

WritePreamble 



last curve. 

Creates a quadratic B§zier curve and adds it to the path. The 
curve is created from the current point to the specified destination 
point using the specified control point The path's current point is 
set to the destination point of the curve. 

Ensures that simple (non-Changeable) members are being 
accessed from a valid Ul context. This method should be called 
before any simple members are accessed. Inherited from 
Changeable. 

Determines whether the specified Object instances are the same 
instance. Inherited from Object. 

This will change the time parent for animations on any of the 
properties of this Changeable which are inheriting their time 
parent. Inherited from Animatable. 

Specifies the beginning point of the figure. A figure must have 
one, and only one, beginning point. 

Returns a String that represents the current Object. Inherited 
from Object. 

Verifies that the current object has a valid state. If the object is in 
an invalid state, this method throws an exception. Inherited from 
Changeable. 

Causes the current object to validate itself and then invokes the 
OnChanged method. Inherited from Changeable. 
Ensures that simple (non-Changeable) members are being 
accessed from a valid user interface (Ul) context. This method 
should be called before any simple members are set. Inherited 
from Changeable. 



Property Description 

Used in conjunction with the ChangeableUsageOverride type sent in 
AllowChangeableReferenceOverride as a Parameter to ChangeableHelper.UseChangeable, to help 

determine when a Changeable being put into "use" should be 
promoted to "ChangeabieReference". Inherited from Changeable. 

True if this Changeable can be made unchangeable. Inherited from 
Changeable. 

The current parent Timeline associated with this Animatable. This 
will be the Timeline set to the ParentTimeline property of this 
Animatable if one has been set and if not, the Timeline last passed 
into the SetDefaultParentTimeline method. Inherited from 
Animatable. 



CanMakeUnchangeable 



DefaultParentTimeline 



HasAnimations 
IsAnimating 



IsChangeable 



IsFilled 

IsOverridingBaseValue 



Gets a Boolean that indicates whether any PathSegment that 
belongs to the figure has animations. 

Gets a Boolean that indicates whether the object is currently 
modifiable. Inherited from Changeable. 
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Segments 



Gets or sets a UseStatus enumeration that specifies how the 
Changeable object behaves when it is "used." A Changeable object 
StatusOfNextUse is consid ered used in the following situations: the object is set into a 

Property System property, the object is used as a sub-object in a 
complex Changeable object, or the object is used in a 
DrawingContext command. Inherited from Changeable. 

UlContext Gets the u| Context of the current object. The UlContext is used for 

maintaining thread safety. Inherited from Changeable. 

Each PathGeometry object defines a collection of PathFigure objects. Each of the PathFigure objects is 
composed of one or more PathSegment objects, such as ArcSegment and BezierSegment which 
actually define their shape. 



PathFigureCollection Class 



Method 

Add 

AddRange 
Clear 

CloneCore 

CloneCore 

CloneDownToUnchangeable 
Contains 

Copy 

Copy 

CopyTo 

DisableCore 

EmbeddedAnimationCollectionReader 
EmbeddedAnimationCollectionWriter 
EmbeddedChangeableReader 
EmbeddedChangeableWriter 
EnableCore 

Equals 
Finalize 

GetCurrentValue 
GetCurrentValue 



Description 

Adds a PathFigure to the end of the collection. 



Returns a modifiable shallow or deep clone of the current object. 
This abstract method must be implemented by classes that 
derive from Changeable. Inherited from Changeable. 

Returns an immutable copy of the specified object. Inherited 
from Changeable. 

Returns a modifiable copy of the current object. The copy's 
IsChangeable property is true and its StatusOfNextUse is 
Unchangeable. Inherited from Changeable. 

Copies the entire PathFigureCollection to a compatible one- 
dimensional Array, starting at the specified index of the target 
array. 

Maybe this should be internal?? Inherited from Animatable. 
Inherited from Animatable. 
Inherited from Animatable. 
Inherited from Animatable. 

Determines whether two Object instances are equal. Inherited 
from Object. 

Allows an Object to attempt to free resources and perform other 
cleanup operations before the Object is reclaimed by garbage 
collection. Inherited from Object. 

Returns a non-animated version of this PathFigureCollection that 
represents its current state. 

Returns a non-animated version of this Animatable that 
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GetEnumerator 

GetHashCode 

GetRange 
GetType 

lAddChild.AddChild 

IAddChild.AddText 

IList.Add 

IList. Contains 

IListlndexOf 

IListlnsert 

I List Remove 

IndexOf 

Insert 

InsertRange 
LastlndexOf 

MakeUnchangeable 

MakeUnchangeableCore 
MemberwiseClone 



ModifyHandlerlfChangeable 



OnChanged 

PathFigureCollection 
PropagateEventHandler 

ReadPreamble 



ReferenceEquals 

Remove 

RemoveAt 

RemoveRange 

SetDefaultParentTimeline 

SetDefaultParentTimelineCore 
SetRange 



represents its current state. Inherited from Animatable. 

Serves as a hash function for a particular type, suitable for use in 
hashing algorithms and data structures like a hash 
table. Inherited from Object. 

Gets the Type of the current instance. Inherited from Object. 



Makes an object immutable; after this method is called on a 
Changeable, its IsChangeable property is false. Inherited from 
Changeable. 

Implementation of MakeUnchangeableCore. 

Creates a shallow copy of the current Object. Inherited from 
Object. 

Adds or removes a Changed event handler to or from the 
specified Changeable object, if the object is currently modifiable. 
If the specified object is not modifiable— if its IsChangeable 
property is false— this method has no effect. Inherited from 
Changeable. 

Called when the current object is modified. Classes that derive 
from Changed should call this method after they have been 
modified. Inherited from Changeable. 

Implementation of PropagateEventHandler. 

Ensures that simple (non-Changeable) members are being 

accessed from a valid U! context. This method should be called 

before any simple members are accessed. Inherited from 

Changeable. 

Determines whether the specified Object instances are the same 
instance. Inherited from Object. 



This will change the time parent for animations on any of the 
properties of this Changeable which are inheriting their time 
parent. Inherited from Animatable. 
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ToString 

ValidateObjectState 
WritePostscript 

WritePreamble 



Returns a String that represents the current Object. Inherited 
from Object. 

Verifies that the current object has a valid state. If the object is in 
an invalid state, this method throws an exception. Inherited from 
Changeable. 

Causes the current object to validate itself and then invokes the 
OnChanged method. Inherited from Changeable. 
Ensures that simple (non-Changeable) members are being 
accessed from a valid user interface (Ul) context. This method 
should be called before any simple members are set. Inherited 
from Changeable. 



Property 



Description 

Used in conjunction with the ChangeableUsageOverride type sent in 



AllowChangeableReferenceOverride * s a P arameter t0 ChangeableHelper.UseChangeable, to help 

determine when a Changeable being put into "use" chnnin ho 



CanMakeUnchangeable 

Capacity 
Count 



DefaultParentTimeiine 

HasAnimations 
IsAnimating 

IsChangeable 

IsFixedSize 

IsOverridingBaseValue 

Item 

StatusOfNextUse 
UlContext 



should be 

promoted to "ChangeableReference". Inherited from Changeable. 

True if this Changeable can be made unchangeable. Inherited from 
Changeable. 



The current parent Timeline associated with this Animatable. This 
will be the Timeline set to the ParentTimeline property of this 
Animatable if one has been set and if not, the Timeline last passed 
into the SetDefaultParentTimeline method. Inherited from 
Animatable. 



Gets a Boolean that indicates whether the object is currently 
modifiable. Inherited from Changeable. 



Gets or sets a UseStatus enumeration that specifies how the 
Changeable object behaves when it is "used." A Changeable object 
is considered used in the following situations: the object is set into a 
Property System property, the object is used as a sub-object in a 
complex Changeable object, or the object is used in a 
DrawingContext command. Inherited from Changeable. 
Gets the UlContext of the current object. The UlContext is used for 
maintaining thread safety. Inherited from Changeable. 



PathFigureConverter Class 

Definition: Path Figure Converter 

Method Description 

CanConvertFrom Inherited from TypeConverter. 

CanConvertTo Inherited from TypeConverter. 

CanConvertTo TypeConverter method override. 
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ConvertFrom 

ConvertFromlnvariantString 

ConvertFromString 

ConvertTo 

ConvertTo 

ConvertTolnvariantString 

ConvertToString 

Createlnstance 

Equals 
Finalize 

GetConvertFromException 

GetConvertToException 

GetCreatelnstanceSupported 

GetHashCode 

GetProperties 

GetPropertiesSupported 

GetStandardValues 

GetStandardValuesExclusive 

GetStandardValuesSupported 

GetType 

IsValid 

MemberwiseClone 
PathFigureConverter 

ReferenceEquals 

SortProperties 

ToString 



Inherited from TypeConverter. 
Inherited from TypeConverter. 
Inherited from TypeConverter. 
Inherited from TypeConverter. 
TypeConverter method implementation. 
Inherited from TypeConverter. 
Inherited from TypeConverter. 
Inherited from TypeConverter. 

Determines whether two Object instances are equal. Inherited from 
Object. 

Allows an Object to attempt to free resources and perform other cleanup 
operations before the Object is reclaimed by garbage 
collection. Inherited from Object. 

Inherited from TypeConverter. 

Inherited from TypeConverter. 

Inherited from TypeConverter. 

Serves as a hash function for a particular type, suitable for use in 
hashing algorithms and data structures like a hash table. Inherited from 
Object. 

Inherited from TypeConverter. 
Inherited from TypeConverter. 
Inherited from TypeConverter. 
Inherited from TypeConverter. 
Inherited from TypeConverter. 

Gets the Type of the current instance. Inherited from Object. 
Inherited from TypeConverter. 

Creates a shallow copy of the current Object. Inherited from Object. 

Determines whether the specified Object instances are the same 
instance. Inherited from Object. 

Inherited from TypeConverter. 

Returns a String that represents the current Object. Inherited from 
Object. 



PathGeometry Class 

Definition: Represents a complex shape that may be composed of arcs, curves, ellipses, lines, and 
rectangles. 

Method Description 

AddFigure Adds a PathFj 9 ure . a collection of PathSegment objects that 

describe a shape, to the path. 

Converts the specified Geometry into a collection of PathFigure 
AddGeometry objects and adds it to the path. If the specified Geometry is 

animated, the conversion from Geometry to PathFigure may 
result in some loss of information. 

AddPointAndTypes 

CloneCore Returns a modifiable shallow or deep clone of the current object. 
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CloneCore 

CloneDownToUnchangeable 
Copy 

Copy 

Copy 

DisableCore 

Dispose 

DoesContain 

EmbeddedAnimationCollectionReader 

EmbeddedAnimationCollectionWriter 

EmbeddedChangeableReader 

EmbeddedChangeableWriter 

EnableCore 

Equals 

Finalize 

GetBounds 

GetCurrentValue 

GetCurrentValue 

GetCurrentValue 

GetHashCode 

GetOutlinedPathGeometry 
GetType 

GetWidened PathGeometry 

lAddChild.AddChild 

lAddChild.AddText 

MakeUnchangeable 

MakeUnchangeableCore 
MemberwiseClone 

ModifyHandlerlfChangeable 



This abstract method must be implemented by classes that 
derive from Changeable. Inherited from Changeable. 

Implementation of Animatable.CloneCore. 

Returns an immutable copy of the specified object. Inherited 
from Changeable. 

Creates a copy of this PathGeometry. 

Returns a modifiable copy of the current object. The copy's 
IsChangeable property is true and its StatusOfNextUse is 
Unchangeable. Inherited from Changeable. 

Creates a copy of this Geometry. Inherited from Geometry. 

Dispose resources associated with geometry. 

Returns if point is inside the geometry. Inherited from Geometry. 

Maybe this should be internal?? Inherited from Animatable. 

Inherited from Animatable. 

Inherited from Animatable. 

Inherited from Animatable. 

Determines whether two Object instances are equal. Inherited 
from Object. 

Inherited from Geometry. 

Returns the bounds of a Geometry, widened according to the 
characteristics of the specified pen. Inherited from Geometry. 

Returns a non-animated version of this PathGeometry that 
represents its current state. 

Returns a non-animated version of this Animatable that 
represents its current state. Inherited from Animatable. 
Returns a non-animated version of this Geometry that 
represents its current state. Inherited from Geometry. 

Serves as a hash function for a particular type, suitable for use 
in hashing algorithms and data structures like a hash 
table. Inherited from Object. 

Gets the Type of the current instance. Inherited from Object. 



Makes an object immutable; after this method is called on a 
Changeable, its IsChangeable property is false. Inherited from 
Changeable. 

Creates a shallow copy of the current Object. Inherited from 

Object. 

Adds or removes a Changed event handler to or from the 
specified Changeable object, if the object is currently modifiable. 
If the specified object is not modifiable — if its IsChangeable 
property is false— this method has no effect. Inherited from 
Changeable. 
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OnChanged 

PathGeometry 
PropagateEventHandler 

ReadPreamble 



ReferenceEquals 

SetDefaultParentTimeline 

SetDefaultParentTimelineCore 
ToString 

VaiidateObjectState 
WritePostscript 

WritePreamble 



Called when the current object is modified. Classes that derive 
from Changed should call this method after they have been 
modified. Inherited from Changeable. 



Ensures that simple (non-Changeable) members are being 
accessed from a valid Ul context. This method should be called 
before any simple members are accessed. Inherited from 
Changeable. 

Determines whether the specified Object instances are the 
same instance. Inherited from Object. 

This will change the time parent for animations on any of the 
properties of this Changeable which are inheriting their time 
parent. Inherited from Animatable. 

Reiurns a Suing mat represents ihe current Object, inherited 
from Object. 

Implementation of Changeabie.VaiidateObjectState. 

Causes the current object to validate itself and then invokes the 
OnChanged method. Inherited from Changeable. 

Ensures that simple (non-Changeable) members are being 
accessed from a valid user interface (Ul) context. This method 
should be called before any simple members are set. Inherited 
from Changeable. 



Property Description 

Used in conjunction with the ChangeableUsageOverride type sent in 

AllowChangeableReferenceOverride " 8 P aram ^er to ChangeableHelper.UseChangeable, to help 

determine when a Changeable being put into "use" should be 
promoted to "ChangeableReference". Inherited from Changeable. 
Gets a Rect that specifies the bounding box of a Geometry. This 
method does not take any pens into account. Inherited from 
Geometry. 

True if this Changeable can be made unchangeable. Inherited from 
Changeable. 

The current parent Timeline associated with this Animatable. This 
will be the Timeline set to the ParentTimeline property of this 
Animatable if one has been set and if not, the Timeline last passed 
into the SetDefaultParentTimeline method. Inherited from 
Animatable. 



Bounds 

CanMakeUnchangeable 

DefaultParentTimeiine 

Figures 
FillRule 

HasAnimations 
IsAnimating 

IsChangeable 

IsOverridingBaseValue 

StatusOfNextUse 



Gets a Boolean that indicates whether the object is currently 
modifiable. Inherited from Changeable. 

Gets or sets a UseStatus enumeration that specifies how the 
Changeable object behaves when it is "used." A Changeable object 
is considered used in the following situations: the object is set into a 
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Property System property, the object is used as a sub-object in a 
complex Changeable object, or the object is used in a 
DrawingContext command. Inherited from Changeable. 

Gets or sets the Transform object applied to a Geometry. Inherited 
from Geometry. 

Gets the UlContext of the current object. The UlContext is used for 
maintaining thread safety. Inherited from Changeable. 

Each PathGeometry object defines a collection of PathFigure objects. Each of the PathFigure objects is 
composed of one or more PathSegment objects, such as ArcSegment and LineSegment, which actually 
define their shape. 

The filled area of the PathGeometry is defined by taking all of the contained PathFigure objects that have 
their IsFilled property set to true and applying the FillRule to determine the enclosed area. 

This example demonstrates how to draw shapes using the Geometry, PathFigure, and PathSegment 
classes. In this example, several shapes are drawn using Geometry objects and are displayed using a 
Path element. 

There is a Geometry class for each basic geometric shape: LineGeometry, EllipseGeometry, and 
RectangleGeometry. Complex shapes, such as polygons and shapes with curved segments, may be 
created using a PathGeometry. 

In the following example, a LineGeometry, EllipseGeometry, and a RectangleGeometry object are used to 
create a line, an ellipse, and a rectangle. 
// C# 

MSAvalon.Windows.Media. LineGeometry myLineGeometry = 
new LineGeometry(new Point(50, 50), new Point(300, 50)); 

MSAvalon.Windows.Media.EllipseGeometry myEllipseGeometry = 
new EllipseGeometry(new Point(440, 100), 40, 75); 

MSAvalon.Windows.Media. RectangleGeometry myRectangleGeometry = 
new RectangleGeometry(new Rect(new Point(400, 225), new Size(100, 50))); 

'VB.NET 

Dim myLineGeometry As new MSAvalon.Windows.Media.LineGeometry( _ 
new MSAvalon.Windows.Point(50, 50), new MSAvalon. Windows. Point(300, 50)) 

Dim myEllipseGeometry As new MSAvalon.Windows.Media.EllipseGeometry( _ 
new MSAvalon. Windows. Point(440, 100), 40, 75) 

Dim myRectangleGeometry As new MSAvalon. Windows.Media.RectangleGeometry(_ 
new MSAvalon. Windows. Rect(new MSAvalon. Windows. Point(400,225), _ 
new MSAvalon.Windows.Size(1 00,50))) 



PathGeometry objects can be used to create complex shapes, such as arcs and curves. PathGeometry 
objects are comprised of one or more PathFigure objects; each PathFigure represents a different "figure" 
or shape. Each PathFigure is itself comprised of one or more PathSegment objects, each representing a 
connected portion of the figure or shape. Segment types include the following: LineSegment, 
BezierSegment, and ArcSegment. 

In the following code, a PathGeometry and a PathFigure are created, and several segments are added to 
the PathFigure to form a shape. There are several ways to add segments to a PathFigure; you can use 
the PathFigure object's "draw segment" commands to automatically create new segments and add them 
to the figure, or you can explicitly create segments and add them manually using the PathFigure object's 



Transform 
UlContext 
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Segments property or AddSegment method. This example shows both ways of adding segments to a 
figure. 

The first segment of a PathFigure must be a StartSegment. The StartSegment may be added by creating 
a new StartSegment and adding it to the PathFigure, or it can be added using the PathFigure object's 
StartAt method. The following code demonstrates adding a StartSegment using the StartAt method. The 
start point is set to (200,50). 
//C# 

MSAvalon. Windows. Media. PathGeometry myPathGeometry = new PathGeometry(); 
MSAvalon.Windows.Media.PathFigure myPathFigure = new PathFigure(); 

// PathFigure objects must have a defined start point before 
// other segments can be added. 
myPathFigure.StartAt(newPoint(200,50)); 

•VB.NET 

Dim myPathGeometry As new MSAvalon.Windows.Media.PathGeometryO 
Dim myPathFigure As new MSAvalon.Windows.Media.PathFigure() 

' PathFigure objects must have a defined start point before 
' other segments can be added. 

myPathFigure.StartAt(new MSAvaIon.Windows.Point(200,50)) 

In the following code, the BezierTo method is used to create three B§zier curves. A fourth curve is 
created by explicitly creating a BezierSegment and adding it to myPathFigure using the AddSegment 
method. After the segments are added to the PathFigure (myPathFigure), the PathFigure is added to the 
PathGeometry. 
//C# 

myPathFigure. BezierTo( 
new Point(400, 100), new Point(400, 200), new Point(200, 300)); 

myPathFigure. BezierTo( 
new Point(400, 300), new Point(400, 100), new Point(200, 50)); 

myPathFigure. BezierTo( 
new Point(0, 100), new Point(0, 200), new Point(200,300)); 

MSAvalon. Windows. Media. BezierSegment my BezierSegment = 
new BezierSegment(new Point(0, 300), new Point(0, 100), new Point(200, 50), true); 

myPathFigure.AddSegment(myBezierSegment); 

myPathGeometry.Figures.Add(myPathFigure); 

'VB.NET 

myPathFigure. BezierTo(new MSAvalon.Windows.Point(400, 100), _ 
new MSAvalon. Windows. Point(400, 200), new MSAvalon. Windows. Point(200, 300)) 

myPathFigure. BezierTo(new MSAvalon. Windows. Point(400, 300), _ 
new MSA valon. Windows. Point(400, 100), new MSAvalon. Windows. Point(200, 50)) 

myPathFigure.BezierTo(new MSAvalon. Windows. Point(0, 100), _ 
new MSA valon. Windows. Point(0, 200), new MSAvalon.Windows.Point(200,300)) 

Dim myBezierSegment As new BezierSegment( _ 
new MSAvalon.Windows.Point(0, 300), new MSAvalon. Windows. Point(0, 100), _ 
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new MSAvalon. Windows. Point(200, 50), true) 
myPathFigure.AddSegment(myBezierSegment) 

1 Add the PathFigure to the PathGeometry 
myPathGeometry.Figures.Add(myPathFigure) 

In the final code example, the geometries are added to a GeometryCollection, and the 
GeometryCollection is used to set the Path element's Data property. Had there been only one geometry, 
it could have been used to set the Data property directly, without the GeometryCollection. 
// C# 

GeometryCollection myGeometryCollection = new GeometryCollectionQ; 
myGeometryCollection.Add(myLineGeometry); 
myGeometryCollection.Add(myEllipseGeometry); 
myGeometryCollection.Add(myRectangleGeometry); 
myGeometryCollection. Add(myPathGeometry); 

Path myPath = new Path(); 
myPath.Data = myGeometryCollection; 

// Set the outline and the fill of the Path element 

myPath. Stroke = Brushes. Blue; 

myPath.StrokeThickness = new Length(5); 

SolidColorBrush solidFill = new SolidColorBrush(); 

myPath. Fill = new RadialGradientBrush(Co!ors.Orange, Colors. Red); 

// Add the Path element to a Canvas. 
myCanvas.Children.Add(myPath); 

'VB.NET 

Dim myGeometryCollection As new MSAvalon.Windows.Media.GeometryCollection() 
myGeometryCollection. Add(myLineGeometry) 
myGeometryCollection.Add(myEllipseGeometry) 
myGeometryCollection.Add(myRectangleGeometry) 
myGeometryCollection. Add(myPathGeometry) 

Dim myPath As new Path() 
myPath.Data = myGeometryCollection 

' Set the outline and the fill of the Path element. 
myPath.Stroke = MSAvalon.Windows.Media.Brushes.Blue 
myPath.StrokeThickness = new MSAvalon. Windows. Length(5) 
Dim solidFill As new MSAvalon.Windows.Media.SoiidColorBrush() 
myPath.Fill = new RadialGradientBrush(MSAvalon.Windows.Media.Colors.Orange, _ 
MSAvalon.Windows.Media.Colors.Red) 

' Add the Path element to a Canvas. 
myCanvas.Children.Add(myPath) 

Geometry objects may also be rendered using the DrawingContext, which supplies a DrawGeometry 
method that may be used to render Geometry objects. Geometry objects may also be used for clipping 
and hit-testing. 
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PathGe metryConverter Class 

Definition: PathGeometryConverter 



Meth d 

CanConvertFrom 

CanConvertFrom 

CanConvertTo 

CanConvertTo 

ConvertFrom 

ConvertFrom 

ConvertFromlnvariantString 

ConvertFromString 

ConvertFromString 

ConvertTo 

ConvertTo 

ConvertTolnvariantString 

ConvertToString 

Createlnstance 

Equals 
Finalize 

GetConvertFromException 

GetConvertToException 

GetCreatelnstanceSupported 

GetHashCode 

GetProperties 

GetPropertiesSupported 

GetStandardValues 

GetStandardValuesExclusive 

GetStandardValuesSupported 

GetType 

IsValid 

MemberwiseClone 
PathGeometryConverter 

ReferenceEquals 

SortProperties 

ToString 



Descripti n 

CanConvertFrom 

Inherited from TypeConverter. 
TypeConverter method override. 

Inherited from TypeConverter. 

Inherited from TypeConverter. 
ConvertFrom 

Inherited from TypeConverter. 
Inherited from TypeConverter. 
ConvertFromString 
Inherited from TypeConverter. 
TypeConverter method implementation. 
Inherited from TypeConverter. 
Inherited from TypeConverter. 
Inherited from TypeConverter. 

Determines whether two Object instances are equal. Inherited from 
Object. 

Allows an Object to attempt to free resources and perform other cleanup 
operations before the Object is reclaimed by garbage 
collection. Inherited from Object. 

Inherited from TypeConverter. 

Inherited from TypeConverter. 

Inherited from TypeConverter. 

Serves as a hash function for a particular type, suitable for use in 
hashing algorithms and data structures like a hash table. Inherited from 
Object. 

Inherited from TypeConverter. 
Inherited from TypeConverter. 
Inherited from TypeConverter. 
Inherited from TypeConverter. 
Inherited from TypeConverter. 

Gets the Type of the current instance. Inherited from Object. 
Inherited from TypeConverter. 

Creates a shallow copy of the current Object. Inherited from Object. 

Determines whether the specified Object instances are the same 
instance. Inherited from Object. 

Inherited from TypeConverter. 

Returns a String that represents the current Object. Inherited from 
Object. 
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Method 



CloneCore 



geometric segments. 

Description 

Returns a modifiable shallow or deep clone of the current object. 
This abstract method must be implemented by classes that 
derive from Changeable. Inherited from Changeable. 
Subclasses must implement this to provide clones of 
themselves. Inherited from Animatable. 
Returns an immutable copy of the specified object. Inherited 
from Changeable. 

Creates a copy of this PathSegment. 
Returns a modifiable copy of the current object. The copy's 
IsChangeable property is true and its StatusOfNextUse is 
Unchangeable. Inherited from Changeable. 



CloneCore 

CloneDownToU nchangeable 
Copy 

Copy 
DisableCore 

EmbeddedAnimationCollectionReader 

EmbeddedAnimationCollectionWriter 

EmbeddedChangeableReader 

EmbeddedChangeableWriter 

EnableCore 

Equals 
Finalize 

GetCurrentValue 
GetCurrentValue 

GetHashCode 
GetType 

MakeUnchangeable 

MakeU nchangeableCore 
MemberwiseCione 

ModifyHandlerlfChangeable 
OnChanged 



Maybe this should be internal?? Inherited from Animatable. 
Inherited from Animatable. 
Inherited from Animatable. 
Inherited from Animatable. 

Determines whether two Object instances are equal. Inherited 
from Object. 

Allows an Object to attempt to free resources and perform other 
cleanup operations before the Object is reclaimed by garbage 
collection. Inherited from Object. 
Returns a non-animated version of this GradientStop that 
represents its current state. 

Returns a non-animated version of this Animatable that 
represents its current state. Inherited from Animatable. 
Serves as a hash function for a particular type, suitable for use in 
hashing algorithms and data structures like a hash 
table. Inherited from Object. 

Gets the Type of the current instance. Inherited from Object. 
Makes an object immutable; after this method is called on a 
Changeable, its IsChangeable property is false. Inhented from 
Changeable. 

Implementation of MakeUnchangeableCore. 

Creates a shallow copy of the current Object. Inherited from 

Object. 

Adds or removes a Changed event handler to or from the 
specified Changeable object, if the object is currently modifiable. 
If the specified object is not modifiabie-if its IsChangeable 
property is faise-this method has no effect. Inhented from 
Changeable. 

Called when the current object is modified. Classes that derive 
from Changed should call this method after they have been 
modified. Inherited from Changeable. 
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PropagateEventHandler 
ReadPreamble 

ReferenceEquals 

SetDefaultParentTimeline 

SetDefaultParentTimelineCore 
ToString 

ValidateObjectState 
WritePostscript 

WritePreamble 



Shares a Changed event handler with the current object's data 
members or removes it. Inherited from Changeable. 
Ensures that simple (non-Changeable) members are being 
accessed from a valid Ul context. This method should be called 
before any simple members are accessed. Inherited from 
Changeable. 

Determines whether the specified Object instances are the same 
instance. Inherited from Object. 

This will change the time parent for animations on any of the 
properties of this Changeable which are inheriting their time 
parent. Inherited from Animatable. 

Returns a String that represents the current Object. Inherited 
from Object. 

Verifies that the current object has a valid state. If the object is in 
an invalid state, this method throws an exception. Inherited from 
Changeable. 

Causes the current object to validate itself and then invokes the 
OnChanged method. Inherited from Changeable. 
Ensures that simple (non-Changeable) members are being 
accessed from a valid user interface (Ul) context. This method 
should be called before any simple members are set. Inherited 
from Changeable. 



Property Description 

Used in conjunction with the ChangeableUsageOverride type sent in 
AllowChangeableReferenceOverride as a P arameter t0 ChangeableHelper.UseChangeable, to help 

determine when a Changeable being put into "use" should be 
promoted to "ChangeableReference". Inherited from Changeable. 

True if this Changeable can be made unchangeable, inherited from 
Changeable. 

The current parent Timeline associated with this Animatable. This 
will be the Timeline set to the ParentTimeline property of this 
Animatable if one has been set and if not, the Timeline last passed 
into the SetDefaultParentTimeline method. Inherited from 
Animatable. 



CanMakeUnchangeable 



DefaultParentTimeline 



HasAnimations 



IsAnimating 



IsChangeable 



IsOverridingBaseValue 



IsStroked 



StatusOfNextUse 



Returns true if any of the properties on this Changeable have 
animations attached. Inherited from Animatable. 
Returns true if any of the properties on this Changeable have 
animations attached that are currently animating their 
value. Inherited from Animatable. 

Gets a Boolean that indicates whether the object is currently 
modifiable. Inherited from Changeable. 
Returns true if any of the properties on this Changeable have 
animations attached that are currently affecting their value either by 
animating it or holding it in a fill state. Inherited from Animatable. 

Gets or sets a Boolean that determines whether the segment is 
stroked. 

Gets or sets a UseStatus enumeration that specifies how the 
Changeable object behaves when it is "used." A Changeable object 
is considered used in the following situations: the object is set into a 
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Property System property, the object is used as a sub-object in a 
complex Changeable object, or the object is used in a 
DrawingContext command. Inherited from Changeable. 

UlContext Gets the u,Context of th © current object. The UlContext is used for 

~ " maintaining thread safety. Inherited from Changeable. 

This example demonstrates how to draw shapes using the Geometry, PathFigure, and PathSegment 
classes. In this example, several shapes are drawn using Geometry objects and are displayed using a 
Path element. 

There is a Geometry class for each basic geometric shape: LineGeometry, EllipseGeometry, and 
RectangleGeometry. Complex shapes, such as polygons and shapes with curved segments, may be 
created using a PathGeometry. 

In the following example, a LineGeometry, EllipseGeometry, and a RectangleGeometry object are used to 
create a line, an ellipse, and a rectangle. 
//C# 

MSAvalon. Windows. Media. LineGeometry myLineGeometry = 
new LineGeometry(new Point(50, 50), new Point(300, 50)); 

MSAvalon.Windows.Media.EllipseGeometry myEllipseGeometry = 
new EllipseGeometry(new Point(440, 100), 40, 75); 

MSAvalon.Windows.Media.RectangleGeometry myRectangleGeometry = 
new RectangleGeometry(new Rect(new Point(400, 225), new Size(100, 50))); 

■VB.NET 

Dim myLineGeometry As new MSAvalon. Windows.Media.LineGeometry( _ 

new MSAvalon. Windows. Point(50, 50), new MSAvalon. Windows. Point(300, 50)) 
Dim myEllipseGeometry As new MSAvalon.Windows.Media.EllipseGeometry( _ 

new MSAvalon. Windows. Point(440, 100), 40, 75) 
Dim myRectangleGeometry As new MSAvalon. Windows.Media.RectangleGeometry( _ 

new MSAvalon. Windows. Rect(new MSAvalon. Windows. Point(400,225), _ 

new MSAvalon.Windows.Size(1 00,50))) 



PathGeometry objects can be used to create complex shapes, such as arcs and curves. PathGeometry 
objects are comprised of one or more PathFigure objects; each PathFigure represents a different "figure" 
or shape. Each PathFigure is itself comprised of one or more PathSegment objects, each representing a 
connected portion of the figure or shape. Segment types include the following: LineSegment, 
BezierSegment, and ArcSegment. 

In the following code, a PathGeometry and a PathFigure are created, and several segments are added to 
the PathFigure to form a shape. There are several ways to add segments to a PathFigure; you can use 
the PathFigure object's "draw segment" commands to automatically create new segments and add them 
to the figure, or you can explicitly create segments and add them manually using the PathFigure object's 
Segments property or AddSegment method. This example shows both ways of adding segments to a 
figure. 

The first segment of a PathFigure must be a StartSegment. The StartSegment may be added by creating 
a new StartSegment and adding it to the PathFigure, or it can be added using the PathFigure object's 
StartAt method. The following code demonstrates adding a StartSegment using the StartAt method. The 
start point is set to (200, 50). 
//C# 

MSAvalon. Windows. Media. PathGeometry my PathGeometry = new PathGeometryQ; 
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MSAvalon. Windows.Media. PathFigure myPathFigure = new PathFigure(); 

// PathFigure objects must have a defined start point before 
// other segments can be added. 
myPathFigure.StartAt(new Point(200,50)); 

•VB.NET 

Dim myPathGeometry As new MSAvalon.Windows.Media.PathGeometry() 
Dim myPathFigure As new MSAvalon. Windows. Media. PathFigureQ 

' PathFigure objects must have a defined start point before 
' other segments can be added. 

myPathFigure.StartAt(new MSAvalon.Windows.Point(200,50)) 

In the following code, the BezierTo method is used to create three B6zier curves. A fourth curve is 
created by explicitly creating a BezierSegment and adding it to myPathFigure using the AddSegment 
method. After the segments are added to the PathFigure (myPathFigure), the PathFigure is added to the 
PathGeometry. 
//C# 

myPathFigure.BezierTo( 

new Point(400, 100), new Point(400 t 200), new Point(200, 300)); 

myPathFigure. BezierTo( 
new Point(400, 300), new Point(400, 100), new Point(200, 50)); 

myPathFigure. BezierTo( 
new Point(0, 100), new Point(0, 200), new Point(200,300)); 

MSAvalon.Windows.Media.BezierSegment myBezierSegment = 
new BezierSegment(new Point(0, 300), new Point(0, 100), new Point(200, 50), true); 

myPathFigure.AddSegment(myBezierSegment); 

myPathGeometry.Figures.Add(myPathFigure); 

'VB.NET 

myPathFigure. BezierTo(new MSAvalon. Windows. Point(400, 100), _ 
new MSAvalon. Windows. Point(400, 200), new MSAvalon. Windows. Point(200, 300)) 

myPathFigure. BezierTo(new MSAvalon.Windows.Point(400, 300), _ 
new MSAvalon. Windows. Point(400, 100), new MSAvalon .Windows. Point(200, 50)) 

myPathFigure. BezierTo(new MSAvalon. Windows. Point(0, 100), _ 
new MSAvalon. Windows. Point(0, 200), new MSAvalon.Windows.Point(200,300)) 

Dim myBezierSegment As new BezierSegment( _ 

new MSAvalon. Windows. Point(0, 300), new MSAvalon. Windows. Point(0, 100), _ 
new MSAvalon. Windows. Point(200, 50), true) 

myPathFigure.AddSegment(myBezierSegment) 

' Add the PathFigure to the PathGeometry 
myPathGeometry.Figures.Add(myPathFigure) 
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In the final code example, the geometries are added to a GeometryCollection, and the 
GeometryCollection is used to set the Path elements Data property. Had there been only one geometry, 
it could have been used to set the Data property directly, without the GeometryCollection. 
// C# 

GeometryCollection myGeometryCollection = new GeometryCollection(); 
myGeometryCollection.Add(myLineGeometry); 
myGeometryCollection.Add(myEllipseGeometry); 
myGeometryCollection.Add(myRectangleGeometry); 
myGeometryCollection. Add(myPathGeometry); 

Path myPath = new PathQ; 
myPath.Data = myGeometryCollection; 

// Set the outline and the fill of the Path element. 

myPath.Stroke = Brushes.Blue; 

myPath.StrokeThickness = new Length(5); 

SolidColorBrush solidFill = new SolidColorBrush(); 

myPath.Fill = new RadialGradientBrush(Colors.Orange, Colors.Red); 

// Add the Path element to a Canvas. 
myCanvas.Children.Add(myPath); 

'VB.NET 

Dim myGeometryCollection As new MSAvalon.Windows.Media.GeometryCollection() 
myGeometryCollection. Add(myLineGeometry) 
myGeometryCollection.Add(myEllipseGeometry) 
myGeometryCoIlection.Add(myRectangleGeometry) 
myGeometryCollection.Add(myPathGeometry) 

Dim my Path As new Path() 
myPath.Data = myGeometryCollection 

' Set the outline and the fill of the Path element. 
myPath.Stroke = MSAvalon.Windows.Media. Brushes.Blue 
myPath.StrokeThickness = new MSAvalon. Windows. Length(5) 
Dim solidFill As new MSAvalon.Windows. Media. SolidColorBrush() 
myPath.Fill = new RadialGradientBrush(MSAvalon.Windows.Media.Colors.Orange, _ 
MSAvalon.Windows.Media. Colors.Red) 

' Add the Path element to a Canvas. 
myCanvas.Children.Add(myPath) 

Geometry objects may also be rendered using the DrawingContext, which supplies a DrawGeometry 
method that may be used to render Geometry objects. Geometry objects may also be used for clipping 
and hit-testing. 



PathSegmentCollection Class 

Definition: Represents a list of PathSegment objects. 



Method 



Description 

Adds a PathSegment to a list and returns the index at which the 
segment is added. 



Add 



AddRange 



Adds the segments contained in the specified 
PathSegmentCollection to the collection. 
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Clear Clears the collection of all segments and resets Count to zero. 

Returns a modifiable shallow or deep clone of the current object. 
CloneCore This abstract method must be implemented by classes that derive 

from Changeable. Inherited from Changeable. 

CloneCore 

Returns an immutable copy of the specified object. Inherited from 
Changeable. 

Returns a Boolean that indicates whether the specified 
PathSegment is contained within the collection. 

Returns a modifiable copy of the current object. The copy's 
IsChangeable property is true and its StatusOfNextUse is 
Unchangeable. Inherited from Changeable. 

Copies the entire PathSegmentCollection to a compatible one- 
dimensional Array, starting at the specified index of the target 
array. 

EmbeddedAnimationCollectionReader Maybe this should be internal?? Inherited from Animatable. 
EmbeddedAnimationCollectionWriter Inherited from Animatable. 
EmbeddedChangeableReader Inherited from Animatable. 

EmbeddedChangeableWriter Inherited from Animatable. 

EnableCore 

Determines whether two Object instances are equal. Inherited from 
Object. 

Allows an Object to attempt to free resources and perform other 
cleanup operations before the Object is reclaimed by garbage 
coiiection. Inherited from Object. 

Returns a non-animated version of this PathSegmentCollection 
that represents its current state. 

Returns a non-animated version of this Animatable that represents 
its current state. Inherited from Animatable. 

Serves as a hash function for a particular type, suitable for use in 
hashing algorithms and data structures like a hash table. Inherited 
from Object. 

Gets the Type of the current instance. Inherited from Object. 
lAddChild.AddChild 
lAddChild.AddText 
IList.Add 
IList.Contains 
IList.lndexOf 
IList.lnsert 
IList.Remove 
IndexOf 
Insert 

InsertRange 



CloneDownToUnchangeable 

Contains 
Copy 

Copy 

CopyTo 
DisableCore 



Equals 
Finalize 

GetCurrentValue 

GetCurrentValue 
GetEnumerator 

GetHashCode 

GetRange 
GetType 
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LastlndexOf 

MakeUnchangeable 

MakeUnchangeableCore 
MemberwiseClone 

ModifyHandlerlfChangeable 

OnChanged 

PathSegmentCollection 
PropagateEventHandler 

ReadPreamble 

ReferenceEquals 

Remove 

RemoveAt 

RemoveRange 

SetDefaultParentTimeline 

SetDefaultParentTimelineCore 
SetRange 

ToString 

ValidateObjectState 
WritePostscript 

WritePreamble 



Makes an object immutable; after this method is called on a 
Changeable, its IsChangeable property is false. Inherited from 
Changeable. 

Implementation of MakeUnchangeableCore. 

Creates a shallow copy of the current Object. Inherited from 
Object. 

Adds or removes a Changed event handler to or from the specified 
Changeable object, if the object is currently modifiable. If the 
specified object is not modifiable — if its IsChangeable property is 
false — this method has no effect. Inherited from Changeable. 

Called when the current object is modified. Classes that derive 
from Changed should call this method after they have been 
modified. Inherited from Changeable. 

Implementation of PropagateEventHandler. 

Ensures that simple (non-Changeable) members are being 
accessed from a valid Ui context. This method should be called 
before any simple members are accessed. Inherited from 
Changeable. 

Determines whether the specified Object instances are the same 
instance. Inherited from Object. 



This will change the time parent for animations on any of the 
properties of this Changeable which are inheriting their time 
parent. Inherited from Animatable. 



Returns a String that represents the current Object. Inherited from 
Object. 

Verifies that the current object has a valid state, if the object is in 
an invalid state, this method throws an exception. Inherited from 
Changeable. 

Causes the current object to validate itself and then invokes the 
OnChanged method. Inherited from Changeable. 

Ensures that simple (non-Changeable) members are being 
accessed from a valid user interface (UI) context. This method 
should be called before any simple members are set. Inherited 
from Changeable. 



Property Description 

Used in conjunction with the ChangeableUsageOverride type sent in 

AllowChangeableReferenceOverride ?, a P arame 5 *° ChangeableHelper.UseChangeable, to help 

determine when a Changeable being put into "use" should be 
promoted to "ChangeabieReference". inherited from Changeable. 

CanMakeUnchangeable I™ e if th 'S Changeable can be made unchangeable. Inherited from 

Changeable. 
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Capacity 
Count 



DefaultParentTimeline 

HasAnimations 
IsAnimating 

IsChangeable 

IsFixedSize 

IsOverridingBaseValue 

Item 

StatusOfNextUse 
UlContext 



The current parent Timeline associated with this Animatable. This 
will be the Timeline set to the ParentTimeline property of this 
Animatable if one has been set and if not, the Timeline last passed 
into the SetDefaultParentTimeline method. Inherited from 
Animatable. 



Gets a Boolean that indicates whether the object is currently 
modifiable. Inherited from Changeable. 



Gets or sets a UseStatus enumeration that specifies how the 
Changeable object behaves when it is "used." A Changeable object 
is considered used in the following situations: the object is set into a 
Property System property, the object is used as a sub-object in a 
complex Changeable object, or the object is used in a 
DrawingContext command. Inherited from Changeable. 

Gets the UlContext of the current object. The UlContext is used for 
maintaining thread safety. Inherited from Changeable. 



PathSegmentConverter Class 

Definition: PathSegmentConverter 



Method 

CanConvertFrom 
CanConvertTo 
CanConvertTo 
ConvertFrom 

ConvertFromlnvariantString 

ConvertFromString 

ConvertTo 

ConvertTo 

ConvertTolnvariantString 

ConvertToString 

Createlnstance 

Equals 
Finalize 

GetConvertFrom Exception 
GetConvertToException 
GetCreatelnstanceSupported 
GetHashCode 



Description 

Inherited from TypeConverter. 

Inherited from TypeConverter. 
TypeConverter method override. 

Inherited from TypeConverter. 

Inherited from TypeConverter. 

Inherited from TypeConverter. 

Inherited from TypeConverter. 
TypeConverter method implementation. 

Inherited from TypeConverter. 

Inherited from TypeConverter. 

Inherited from TypeConverter. 

Determines whether two Object instances are equal. Inherited from 
Object. 

Allows an Object to attempt to free resources and perform other cleanup 
operations before the Object is reclaimed by garbage 
collection. Inherited from Object. 

Inherited from TypeConverter. 

Inherited from TypeConverter. 

Inherited from TypeConverter. 

Serves as a hash function for a particular type, suitable for use in 
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GetProperties 

GetPropertiesSupported 

GetStandardValues 

GetStandardValuesExclusive 

GetStandardValuesSupported 

GetType 

isValid 

MemberwiseClone 
PathSegmentConverter 

ReferenceEquals 

SortProperties 

ToString 



hashing algorithms and data structures like a hash table. Inherited from 
Object. 

Inherited from TypeConverter. 
Inherited from TypeConverter. 
Inherited from TypeConverter. 
Inherited from TypeConverter. 
Inherited from TypeConverter. 

Gets the Type of the current instance. Inherited from Object. 
Inherited from TypeConverter. 

Creates a shallow copy of the current Object. Inherited from Object. 

Determines whether the specified Object instances are the same 
instance. Inherited from Object. 

Inherited from TypeConverter. 

Returns a String that represents the current Object. Inherited from 
Object. 



Pen Class 

Definition: Describes how a shape is outlined. 



Method 

CloneCore 
CloneCore 

CloneDownToUnchangeable 

Copy 
Copy 

DisableCore 

EmbeddedAnimationCollectionReader 
EmbeddedAnimationCollectionWriter 
EmbeddedChangeableReader 
EmbeddedChangeableWriter 
EnableCore 

Equals 

Finalize 

GetCurrentValue 
GetCurrentValue 

GetHashCode 



Description 

Implementation of Animatable.CloneCore. 
Returns a modifiable shallow or deep clone of the current object. 
This abstract method must be implemented by classes that 
derive from Changeable. Inherited from Changeable. 

Returns an immutable copy of the specified object. Inherited 
from Changeable. 

Returns a modifiable copy of the current object. The copy's 
IsChangeable property is true and its StatusOfNextUse is 
Unchangeable. Inherited from Changeable. 
Creates a copy of this Pen. 

Maybe this should be internal?? Inherited from Animatable. 
Inherited from Animatable. 
Inherited from Animatable. 
Inherited from Animatable. 

Determines whether two Object instances are equal. Inherited 
from Object. 

Returns a non-animated version of this Pen that represents its 
current state. 

Returns a non-animated version of this Animatable that 
represents its current state. Inherited from Animatable. 
Serves as a hash function for a particular type, suitable for use in 
hashing algorithms and data structures like a hash 
table. Inherited from Object. 
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GetType 

MakeUnchangeable 

MakeUnchangeableCore 
MemberwiseClone 

ModifyHandlerlfChangeable 

OnChanged 
Pen 

PropagateEventHandler 
Read Preamble 

ReferenceEquals 

SetDefaultParentTimeline 

SetDefaultParentTimelineCore 
ToString 

ValidateObjectState 
WritePostscript 

WritePreamble 



Gets the Type of the current instance. Inherited from Object. 
Makes an object immutable; after this method is called on a 
Changeable, its IsChangeable property is false. Inherited from 
Changeable. 

Implementation of MakeUnchangeableCore. 

Creates a shallow copy of the current Object. Inherited from 
Object. 

Adds or removes a Changed event handler to or from the 
specified Changeable object, if the object is currently modifiable. 
If the specified object is not modifiable— if its IsChangeable 
property is false— this method has no effect. Inherited from 
Changeable. 

Called when the current object is modified. Classes that derive 

from Changed should call this method after they have been 

modified. Inherited from Changeable. 

Initializes a new instance of the Pen class. 

Implementation of PropagateEventHandler. 

Ensures that simple (non-Changeable) members are being 

accessed from a valid Ul context. This method should be called 

before any simple members are accessed. Inherited from 

Changeable. 

Determines whether the specified Object instances are the same 
instance. Inherited from Object. 

This will change the time parent for animations on any of the 
properties of this Changeable which are inheriting their time 
parent. Inherited from Animatable. 

Returns a String that represents the current Object. Inherited 
from Object. 

Verifies that the current object has a valid state. If the object is in 
an invalid state, this method throws an exception. Inherited from 
Changeable. 

Causes the current object to validate itself and then invokes the 
OnChanged method. Inherited from Changeable. 
Ensures that simple (non-Changeable) members are being 
accessed from a valid user interface (Ul) context. This method 
should be called before any simple members are set. Inherited 
from Changeable. 



Property 



Description 

Used in conjunction with the ChangeableUsageOverride type sent in 

AllowChangeableReferenceOverride as a P arameterto ChangeableHelper.UseChangeable, to help 

determine when a Changeable being put into "use" should be 
promoted to "ChangeabieReference". Inherited from Changeable. 
Gets or sets the fill of an outline. 

CanMakeUnchangeable True if this Changeable can be made unchangeable. Inherited from 

Changeable. 

DashArray Gets or sets the pattern of dashes and gaps used to stroke paths. 

Gets or sets a PenDashCap enumeration that specifies how the 
ends of each dash is drawn. 



Brush 



DashCap 
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DashOffset 
DashOffsetAnimations 

DefauitParentTimeline 

EndLineCap 

HasAnimations 

IsAnimating 

IsChangeable 

IsOverridingBaseValue 

LineJoin 

MiterLimit 
StartLineCap 

StatusOfNextUse 

Thickness 

ThicknessAnimations 
UlContext 



Gets or sets the offset to the start location of the dash pattern. 
When you set the value you specify that the dash pattern should 
start at a location other than the origin of the stroke. 

Gets or sets a collection of DoubleModifier objects that animate a 
pen's DashOffset property. 

The current parent Timeline associated with this Animatable. This 
will be the Timeline set to the ParentTimeline property of this 
Animatable if one has been set and if not, the Timeline last passed 
into the SetDefauitParentTimeline method. Inherited from 
Animatable. 

Gets or sets the type of shape to use at the end of a stroke. 

Gets a Boolean that indicates whether the pen or its Brush has 
animations. 

Gets a Boolean that indicates whether the object is currently 
modifiable. Inherited from Changeable. 

Gets or sets the type of joint used at the vertices of a shape's 
outline. 

Gets or sets the limit on the ratio of the miter length to the Thickness 
of a Pen. 

Gets or sets the type of shape to use at the beginning of a stroke. 
Gets or sets a UseStatus enumeration that specifies how the 
Changeable object behaves when it is "used." A Changeable object 
is considered used in the following situations: the object is set into a 
Property System property, the object is used as a sub-object in a 
complex Changeable object, or the object is used in a 
DrawingContext command. Inherited from Changeable. 
Gets or sets the width of the stroke. 

Gets or sets a collection of DoubleModifier objects that animate the 
pen's Thickness. 

Gets the UlContext of the current object. The UlContext is used for 
maintaining thread safety. Inherited from Changeable. 



PixelFormats Class 

Definition: PixelFormats - The collection of supported Pixel Formats. 



Method 

Equals 

Finalize 

GetHashCode 
GetType 

MemberwiseClone 
PixelFormats 



Description 

Determines whether two Object instances are equal. Inherited from Object. 
Allows an Object to attempt to free resources and perform other cleanup 
operations before the Object is reclaimed by garbage collection. Inherited from 
Object. 

Serves as a hash function for a particular type, suitable for use in hashing 
algorithms and data structures like a hash table. Inherited from Object. 
Gets the Type of the current instance. Inherited from Object. 
Creates a shallow copy of the current Object. Inherited from Object. 

Determines whether the specified Object instances are the same 
instance. Inherited from Object 
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ReferenceEquals 

ToStrina Returns a String that represents the current Object. Inherited from Object. 



Property 


Description 


ABGR128 


ABGR128: 128 bpp extended format; Gamma is 1.0 


ARGB32 


ARGB32: 32 bpp SRGB format 


ARGB64 


ARGB64: 64 bpp extended format; Gamma is 1.0 


BGR24 


BGR24: 24 bpp SRGB format 


BlackWhite 


BlackWhite: Monochrome, 2-color image, black and white only. 


CMYK32 


CMYK32: 32 bpp format 


DontCare 


DontCare: for situations when the pixel format may not be important 


Grayl 


Grayl: Image with 2 shades of gray (same as BlackWhite) 


Gray2 


Gray2: Image with 4 shades of gray 


Gray32 


Gray32: 32 bpp Gray-scale format; Gamma is 1.0 


Gray4 


Gray4: Image with 16 shades of gray 


Gray8 


Gray8: Image with 256 shades of gray 


Indexed 1 


Indexed! Paletted image with 2 colors. 


Indexed2 


Indexed2: Paletted image with 4 colors. 


Indexed4 


Indexed4: Paletted image with 16 colors. 


Indexed8 


Indexed8: Paletted image with 256 colors. 


PABGR128 


PABGR128: 128 bpp extended format; Gamma is 1.0 


PARGB32 


PARGB32: 32 bpp SRGB format 


PARGB64 


PARGB64: 64 bpp extended format; Gamma is 1.0 


RGB24 


RGB24: 24 bpp SRGB format 


RGB32 


RGB32: 32 bpp SRGB format 


RGB48 


RGB48: 48 bpp extended format; Gamma is 1.0 


RGB555 


RGB555: 16 bpp SRGB format 


RGB565 


RGB565: 16 bpp SRGB format 


Undefined 


Undefined: the pixel format is not known 



PointCollection Class 

Method Description 

Add 

AddRange 

Clear 

CloneCore 

Returns an immutable copy of the specified object. Inherited from 
CloneDownToUnchangeable Changeable. 
Contains 

Returns a modifiable copy of the current object. The copy's 
Copy IsChangeable property is true and its StatusOfNextUse is 

Unchangeable. Inherited from Changeable. 

Copy 
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CopyTo 

Accesses the specified Changeable data member, processes it, and 
returns a reference to the member. This reference should then be 
EmbeddedChangeableReader reassigned to the original member variable. Classes that derive from 

Changeable call this method on data members before they can be 
retrieved through property calls. Inherited from Changeable. 
Processes a modified Changeable data member and returns a reference 
to the processed object. Inherited from Changeable. 

Determines whether two Object instances are equal. Inherited from 
Object. 

Allows an Object to attempt to free resources and perform other cleanup 
operations before the Object is reclaimed by garbage 
collection. Inherited from Object. 



EmbeddedChangeableWriter 
Equals 



Finalize 
GetEnumerator 



GetHashCode 

GetRange 
GetType 

IAddChild.AddChild 

lAddChild.AddText 

IList.Add 

IList.Contains 

IList.lndexOf 

IList.lnsert 

I List. Remove 

IndexOf 

Insert 

InsertRange 
LastlndexOf 

MakeUnchangeable 

MakellnchangeableCore 
MemberwiseClone 

ModifyHandlerlfChangeable 



OnChanged 

PointCollection 
PropagateEventHandler 

ReadPreamble 



Serves as a hash function for a particular type, suitable for use in 
hashing algorithms and data structures like a hash table. Inherited from 
Object. 

Gets the Type of the current instance. Inherited from Object. 



Makes an object immutable; after this method is called on a 
Changeable, its IsChangeable property is false. Inherited from 
Changeable. 

Makes a Changeable object immutable. Inherited from Changeable. 
Creates a shallow copy of the current Object. Inherited from Object. 
Adds or removes a Changed event handler to or from the specified 
Changeable object, if the object is currently modifiable. If the specified 
object is not modifiable — if its IsChangeable property is false — this 
method has no effect Inherited from Changeable. 

Called when the current object is modified. Classes that derive from 
Changed should call this method after they have been 
modified. Inherited from Changeable. 

Shares a Changed event handler with the current object's data members 
or removes it. Inherited from Changeable. 

Ensures that simple (non-Changeable) members are being accessed 
from a valid Ul context. This method should be called before any simple 
members are accessed. Inherited from Changeable. 
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Determines whether the specified Object instances are the same 
instance. Inherited from Object 



Returns a String that represents the current Object. Inherited from 
Object. 

Verifies that the current object has a valid state. If the object is in an 
invalid state, this method throws an exception. Inherited from 
Changeable. 

Causes the current object to validate itself and then invokes the 
OnChanged method. Inherited from Changeable. 
Ensures that simple (non-Changeable) members are being accessed 
from a valid user interface (Ul) context. This method should be called 
before any simple members are set. Inherited from Changeable. 

Property Description 

Used in conjunction with the ChangeableUsageOverride type sent in 
AllowChangeableReferenceOverride as a P arameter to ChangeableHelper.UseChangeable, to help 

determine when a Changeable being put into "use" should be 
promoted to "ChangeableReference". Inherited from Changeable. 

CanMakeUnchangeable True if this Changeable can be made unchangeable. Inherited from 

Changeable. 

Capacity 
Count 

IsChangeable Gets a Boole an that indicates whether the object is currently 

modifiable. Inherited from Changeable. 

IsFixedSize 
Item 

Gets or sets a UseStatus enumeration that specifies how the 
Changeable object behaves when it is "used." A Changeable object 
StatusOfNextUse is consider ed used in the following situations: the object is set into a 

Property System property, the object is used as a sub-object in a 
complex Changeable object, or the object is used in a 
DrawingContext command. Inherited from Changeable. 

UlContext Gets the UlContext of the current object. The UlContext is used for 

maintaining thread safety. Inherited from Changeable. 



ReferenceEquals 

Remove 
RemoveAt 
RemoveRange 
SetRange 

ToString 

ValidateObjectState 
WritePostscript 

WritePreamble 



PointCollectionConverter Class 

Definition: PointCollectionConverter - Converter class for converting instances of other types to and from 
PointCol lection instances. 

Method Description 

CanConvertFrom CanConvertFrom - Returns whether or not this class can convert from a 

given type. 

CanConvertFrom Inherited from TypeConverter. 

CanConvertTo Inherited from TypeConverter. 
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CanConvertTo 

ConvertFrom 

ConvertFrom 

ConvertFromlnvariantString 

ConvertFromString 

ConvertTo 

ConvertTo 

ConvertTolnvariantString 

ConvertToString 

Createlnstance 

Equals 
Finalize 

GetConvertFromException 

GetConvertToException 

GetCreatelnstanceSupported 

GetHashCode 

GetProperties 

GetPropertiesSupported 

GetStandardValues 

GetStandardValuesExclusive 

GetStandardValuesSupported 

GetType 

IsValid 

MemberwiseClone 
PointCollectionConverter 

ReferenceEquals 

SortProperties 

ToString 



CanConvertTo - Returns whether or not this class can convert to a given 
type- 
Inherited from TypeConverter. 

ConvertFrom - Attempt to convert to a PointCollection from the given 
object 

Inherited from TypeConverter. 
Inherited from TypeConverter. 
Inherited from TypeConverter. 

ConvertTo - Attempt to convert a PointCollection to the given type 
Inherited from TypeConverter. 
Inherited from TypeConverter. 
Inherited from TypeConverter. 

Determines whether two Object instances are equal. Inherited from 
Object. 

Allows an Object to attempt to free resources and perform other cleanup 
operations before the Object is reclaimed by garbage 
collection. Inherited from Object. 

Inherited from TypeConverter. 

Inherited from TypeConverter. 

Inherited from TypeConverter. 

Serves as a hash function for a particular type, suitable for use in 
hashing algorithms and data structures like a hash table. Inherited from 
Object. 

Inherited from TypeConverter. 
Inherited from TypeConverter. 
Inherited from TypeConverter. 
Inherited from TypeConverter. 
Inherited from TypeConverter. 

Gets the Type of the current instance. Inherited from Object. 
Inherited from TypeConverter. 

Creates a shallow copy of the current Object. Inherited from Object 

Determines whether the specified Object instances are the same 
instance. Inherited from Object. 

Inherited from TypeConverter. 

Returns a String that represents the current Object. Inherited from 
Object. 



PointHitTestParameters Class 

Definition: This is the class for specifying parameters hit testing with a point. 



Equals 
Finalize 



Method Description 

Determines whether two Object instances are equal. Inherited from Object. 
Allows an Object to attempt to free resources and perform other cleanup 
operations before the Object is reclaimed by garbage collection. Inherited from 
Object. 
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GetHashCode Serves as a hash function for a particular type, suitable for use in hashing 

algorithms and data structures like a hash table. Inherited from Object 
GetType Gets the Type of the current instance. Inherited from Object. 

MemberwiseClone Creates a shallow copy of the current Object. Inherited from Object. 
PointHitTestParameters The constructor takes the point to hit test with. 

ReferenceEquals Determines whether the specified Object instances are the same 

instance. Inherited from Object. 

ToString Returns a String that represents the current Object. Inherited from Object. 

Property Description — — 

HitPoint The point to hit test against. 



PointHitTestResult Class 

Definition: This class returns the point and visual hit during a hit test pass. 



Method 

Equals 

Finalize 

GetHashCode 
GetType 

MemberwiseClone 
PointHitTestResult 

ReferenceEquals 
ToString 



Description 

Determines whether two Object instances are equal. Inherited from Object. 
Allows an Object to attempt to free resources and perform other cleanup 
operations before the Object is reclaimed by garbage collection. Inherited from 
Object. 

Serves as a hash function for a particular type, suitable for use in hashing 
algorithms and data structures like a hash table. Inherited from Object. 
Gets the Type of the current instance. Inherited from Object. 
Creates a shallow copy of the current Object. Inherited from Object. 
This constructor takes a visual and point respresenting a hit. 

Determines whether the specified Object instances are the same 
instance. Inherited from Object. 

Returns a String that represents the current Object. Inherited from Object. 



Property Description 

Point The point in local space of the hit visual. 

Visual Returns the visual that was hit. Inherited from HitTestResult. 



PolyBezierSegment Class 

Definition: PolyBezierSegment 



Method 



CloneCore 



CloneCore 

CloneDownToUnchangeable 
Copy 



Description 

Returns a modifiable shallow or deep clone of the current object. 
This abstract method must be implemented by classes that 
derive from Changeable. Inherited from Changeable. 
Implementation of Animatable.CloneCore. 

Returns an immutable copy of the specified object. Inherited 
from Changeable. 

Creates a copy of this PathSegment. Inherited from 
PathSegment. 
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Copy 
Copy 

DisableCore 

EmbeddedAnimationCollectionReader 

EmbeddedAnimationCollectionWriter 

EmbeddedChangeableReader 

EmbeddedChangeableWriter 

EnableCore 

Equals 
Finalize 

GetCurrentValue 
GetCurrentValue 
GetCurrentValue 

GetHashCode 
GetType 

MakeUnchangeable 

MakeUnchangeableCore 
MemberwiseClone 



ModifyHandlerlfChangeable 



OnChanged 

PolyBezierSegment 
PropagateEventHandler 

ReadPreamble 



ReferenceEquals 
SetDefaultParentTimeline 



Returns a modifiable copy of the current object. The copy's 
IsChangeable property is true and its Statu sOfNextUse is 
Unchangeable. Inherited from Changeable. 

Cretes a copy of this PolyBezierSegment. 

Inherited from PathSegment. 

Maybe this should be internal?? Inherited from Animatable. 
Inherited from Animatable. 
Inherited from Animatable. 



Inherited from Animatable. 
Inherited from PathSegment. 

Determines whether two Object instances are equal. Inherited 
from Object. 

Allows an Object to attempt to free resources and perform other 
cleanup operations before the Object is reclaimed by garbage 
collection. Inherited from Object. 

Returns a non-animated version of this GradientStop that 
represents its current state. Inherited from PathSegment. 

Returns a non-animated version of this PolyBezierSegment that 
represents its current state. 

Returns a non-animated version of this Animatable that 
represents its current state. Inherited from Animatable. 

Serves as a hash function for a particular type, suitable for use 
in hashing algorithms and data structures like a hash 
table. Inherited from Object 

Gets the Type of the current instance. Inherited from Object. 
Makes an object immutable; after this method is called on a 
Changeable, its IsChangeable property is false. Inherited from 
Changeable. 

Implementation of MakeUnchangeableCore. 

Creates a shallow copy of the current Object. Inherited from 
Object. 

Adds or removes a Changed event handler to or from the 
specified Changeable object, if the object is currently modifiable. 
If the specified object is not modifiable — if its IsChangeable 
property is false— this method has no effect. Inherited from 
Changeable. 

Called when the current object is modified. Classes that derive 
from Changed should call this method after they have been 
modified. Inherited from Changeable. 

Implementation of PropagateEventHandler. 
Ensures that simple (non-Changeable) members are being 
accessed from a valid user interface (Ul) context. This method 
should be called before any simple members are 
accessed. Inherited from Changeable. 

Determines whether the specified Object instances are the 
same instance. Inherited from Object. 

This will change the time parent for animations on any of the 
properties of this Changeable which are inheriting their time 
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SetDefaultParentTimelineCore 
ToString 

ValidateObjectState 
WritePostscript 

WritePreamble 



parent. Inherited from Animatable. 
Inherited from PathSegment. 

Returns a String that represents the current Object. Inherited 
from Object. 

Verifies that the current object has a valid state. If the object is 
in an invalid state, this method throws an exception. Inherited 
from Changeable. 

Causes the current object to validate itself and then invokes the 
OnChanged method. Inherited from Changeable. 
Ensures that simple (non-Changeable) members are being 
accessed from a valid Ul context. This method should be called 
before any simple members are set. Inherited from Changeable. 



Property Description 

Used in conjunction with the ChangeableUsageOverride type sent in 

AllowChangeableReferenceOverride as a P arameter t0 ChangeableHelper.UseChangeable, to help 

determine when a Changeable being put into "use" should be 
promoted to "ChangeableReference". Inherited from Changeable. 

True if this Changeable can be made unchangeable. Inherited from 
Changeable. 

The current parent Timeline associated with this Animatable. This 
will be the Timeline set to the ParentTimeline property of this 
Animatable if one has been set and if not, the Timeline last passed 
into the SetDefaultParentTimeline method. Inherited from 
Animatable. 



CanMakeUnchangeable 



DefaultParentTimeline 



HasAnimations 
IsAnimating 

IsChangeable 

IsOverridingBaseValue 

IsStroked 

Points 

StatusOfNextUse 
UlContext 



Gets a Boolean that indicates whether the segment has animations. 

Gets a Boolean that indicates whether the object is currently 
modifiable. Inherited from Changeable. 

Gets or sets a Boolean that determines whether the segment is 
stroked. Inherited from PathSegment. 

Gets or sets a UseStatus enumeration that specifies how the 
Changeable object behaves when it is "used." A Changeable object 
is considered used in the following situations: the object is set into a 
Property System property, the object is used as a sub-object in a 
complex Changeable object, or the object is used in a 
DrawingContext command. Inherited from Changeable. 
Gets the UlContext of the current object. The UlContext is used for 
maintaining thread safety. Inherited from Changeable. 



PolyLineSegment Class 

Definition: PolyLineSegment 

Method Description 

Returns a modifiable shallow or deep clone of the current object. 
CloneCore This abstract method must be implemented by classes that 

.__ derive from Changeable. Inherited from Changeable. 
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CloneCore Implementation of Animatable.CloneCore. 

CloneDownToUnchangeable , Retu ™ an im ™ table C0 PV of the s P ecified ob i e ^ Inherited 

* from Changeable. 

c Creates a copy of this PathSegment. Inherited from 

py PathSegment. 

Returns a modifiable copy of the current object. The copy's 
Copy IsChangeable property is true and its StatusOfNextUse is 

Unchangeable. Inherited from Changeable. 
Copy Cretes a copy of this PolyLtneSegment. 

DisableCore Inherited from PathSegment. 

EmbeddedAnimationCollectionReader Maybe this should be internal?? Inherited from Animatable. 
EmbeddedAnimationCollectionWriter Inherited from Animatable. 



EmbeddedChangeableReader 

EmbeddedChangeableWriter 

EnableCore 

Equals 
Finalize 

GetCurrentValue 
GetCurrentValue 
GetCurrentValue 

GetHashCode 
GetType 

MakeUnchangeable 

MakeUnchangeableCore 
MemberwiseClone 

ModifyHandlerlfChangeable 

OnChanged 

PolyLineSegment 
PropagateEventHandler 

ReadPreamble 



Inherited from Animatable. 
Inherited from Animatable. 
Inherited from PathSegment. 

Determines whether two Object instances are equal. Inherited 
from Object. 

Allows an Object to attempt to free resources and perform other 
cleanup operations before the Object is reclaimed by garbage 
collection. Inherited from Object. 

Returns a non-animated version of this GradientStop that 
represents its current state. Inherited from PathSegment. 

Returns a non-animated version of this PolyLineSegment that 
represents its current state. 

Returns a non-animated version of this Animatable that 
represents its current state. Inherited from Animatable. 

Serves as a hash function for a particular type, suitable for use in 
hashing algorithms and data structures like a hash 
table. Inherited from Object. 

Gets the Type of the current instance. Inherited from Object. 
Makes an object immutable; after this method is called on a 
Changeable, its IsChangeable property is false. Inherited from 
Changeable. 

Implementation of MakeUnchangeableCore. 

Creates a shallow copy of the current Object. Inherited from 
Object. 

Adds or removes a Changed event handler to or from the 
specified Changeable object, if the object is currently modifiable. 
If the specified object is not modifiable — if its IsChangeable 
property is false— this method has no effect. Inherited from 
Changeable. 

Called when the current object is modified. Classes that derive 
from Changed should call this method after they have been 
modified. Inherited from Changeable. 

Implementation of PropagateEventHandler. 

Ensures that simple (non-Changeable) members are being 
accessed from a valid Ul context. This method should be called 
before any simple members are accessed. Inherited from 
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ReferenceEquals 

SetDefaultParentTimeline 

SetDefaultParentTimelineCore 
ToString 

ValidateObjectState 
WritePostscript 

WritePreamble 



Changeable. 

Determines whether the specified Object instances are the same 
instance. Inherited from Object. 

This will change the time parent for animations on any of the 
properties of this Changeable which are inheriting their time 
parent. Inherited from Animatable. 

Inherited from PathSegment. 

Returns a String that represents the current Object. Inherited 
from Object. 

Verifies that the current object has a valid state. If the object is in 
an invalid state, this method throws an exception. Inherited from 
Changeable. 

Causes the current object to validate itself and then invokes the 
OnChanged method. Inherited from Changeable. 
Ensures that simple (non-Changeable) members are being 
accessed from a valid user interface (Ul) context. This method 
should be called before any simple members are set. Inherited 
from Changeable. 



Property 



Description 

Used in conjunction with the ChangeableUsageOverride type sent in 

AllowChangeableReferenceOverride * s a P arameter t0 ChangeableHelper.UseChangeable, to help 

determine when a Changeable being put into "use" should be 
promoted to "ChangeableReference". Inherited from Changeable. 

True if this Changeable can be made unchangeable. Inherited from 
Changeable. 

The current parent Timeline associated with this Animatable. This 
will be the Timeline set to the ParentTimeline property of this 
Animatable if one has been set and if not, the Timeline last passed 
into the SetDefaultParentTimeline method. Inherited from 
Animatable. 



CanMakeUnchangeable 



DefaultParentTimeline 



HasAnimations 
IsAnimating 

IsChangeable 

IsOverridingBaseValue 

IsStroked 

Points 

StatusOfNextUse 
UlContext 



Gets a Boolean that indicates whether the segment has animations. 

Gets a Boolean that indicates whether the object is currently 
modifiable. Inherited from Changeable. 

Gets or sets a Boolean that determines whether the segment is 
stroked. Inherited from PathSegment. 

Gets or sets a UseStatus enumeration that specifies how the 
Changeable object behaves when it is "used." A Changeable object 
is considered used in the following situations: the object is set into a 
Property System property, the object is used as a sub-object in a 
complex Changeable object, or the object is used in a 
DrawingContext command. Inherited from Changeable. 
Gets the UlContext of the current object. The UlContext is used for 
maintaining thread safety. Inherited from Changeable. 
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P lyQuadraticBezierSegment Class 

Definition: PolyQuadraticBezierSegment 



Method 

CloneCore 
CloneCore 

CloneDownToUnchangeable 
Copy 

Copy 
Copy 

DisableCore 

EmbeddedAnimationCollectionReader 

EmbeddedAnimationCollectionWriter 

EmbeddedChangeableReader 

EmbeddedChangeableWriter 

EnableCore 

Equals 
Finalize 

GetCurrentValue 
GetCurrentValue 
GetCurrentValue 

GetHashCode 
GetType 

MakeUnchangeable 

MakeUnchangeableCore 
MemberwiseClone 

ModifyHandlerlfChangeable 
OnChanged 



Descripti n 

Returns a modifiable shallow or deep clone of the current object. 
This abstract method must be implemented by classes that 
derive from Changeable. Inherited from Changeable. 
Implementation of Animatable.CloneCore. 

Returns an immutable copy of the specified object. Inherited 
from Changeable. 

Creates a copy of this PathSegment. Inherited from 
PathSegment. 

Returns a modifiable copy of the current object. The copy's 
IsChangeable property is true and its StatusOfNextUse is 
Unchangeable. Inherited from Changeable. 
Cretes a copy of this PolyQuadraticBezierSegment. 
Inherited from PathSegment. 

Maybe this should be internal?? Inherited from Animatable. 
Inherited from Animatable. 
Inherited from Animatable. 
Inherited from Animatable. 
Inherited from PathSegment. 

Determines whether two Object instances are equal. Inherited 
from Object. 

Allows an Object to attempt to free resources and perform other 
cleanup operations before the Object is reclaimed by garbage 
collection. Inherited from Object. 

Returns a non-animated version of this GradientStop that 
represents its current state. Inherited from PathSegment. 
Returns a non-animated version of this Animatable that 
represents its current state. Inherited from Animatable. 
Returns a non-animated version of this 
PolyQuadraticBezierSegment that represents its current state. 
Serves as a hash function for a particular type, suitable for use in 
hashing algorithms and data structures like a hash 
table. Inherited from Object. 

Gets the Type of the current instance. Inherited from Object. 
Makes an object immutable; after this method is called on a 
Changeable, its IsChangeable property is false. Inherited from 
Changeable. 

Implementation of MakeUnchangeableCore. 

Creates a shallow copy of the current Object. Inherited from 
Object. 

Adds or removes a Changed event handler to or from the 
specified Changeable object, if the object is currently modifiable. 
If the specified object is not modifiable— if its IsChangeable 
property is false— this method has no effect. Inherited from 
Changeable. 

Called when the current object is modified. Classes that derive 
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PolyQuadraticBezierSegment 
PropagateEventHandler 

ReadPreamble 

ReferenceEquals 

SetDefaultParentTimeline 

SetDefaultParentTimelineCore 
ToString 

ValidateObjectState 
WritePostscript 

WritePreamble 



from Changed should call this method after they have been 
modified. Inherited from Changeable. 

Implementation of PropagateEventHandler. 

Ensures that simple (non-Changeable) members are being 
accessed from a valid Ul context. This method should be called 
before any simple members are accessed. Inherited from 
Changeable. 

Determines whether the specified Object instances are the same 
instance. Inherited from Object. 

This will change the time parent for animations on any of the 
properties of this Changeable which are inheriting their time 
parent. Inherited from Animatable. 

Inherited from PathSegment. 

Returns a String that represents the current Object. Inherited 
from Object. 

Verifies that the current object has a valid state. If the object is in 
an invalid state, this method throws an exception. Inherited from 
Changeable. 

Causes the current object to validate itself and then invokes the 
OnChanged method. Inherited from Changeable. 

Ensures that simple (non-Changeable) members are being 
accessed from a valid user interface (Ul) context. This method 
should be called before any simple members are set. Inherited 
from Changeable. 



Property Description 

Used in conjunction with the ChangeableUsageOverride type sent in 

AllowChangeableReferenceOverride " 8 P aramc f r to ChangeableHelper.UseChangeable, to help 

determine when a Changeable being put into "use" should be 
promoted to "ChangeableReference". Inherited from Changeable. 

True if this Changeable can be made unchangeable. Inherited from 
Changeable. 

The current parent Timeline associated with this Animatable. This 
will be the Timeline set to the ParentTimeline property of this 
Animatable if one has been set and if not, the Timeline last passed 
into the SetDefaultParentTimeline method. Inherited from 
Animatable. 



CanMakeUnchangeable 

DefaultParentTimeline 

HasAnimations 
IsAnimating 

IsChangeable 

I sO verrid i ng Base Va I ue 

IsStroked 

Points 

StatusOfNextUse 



Gets a Boolean that indicates whether the segment has animations. 

Gets a Boolean that indicates whether the object is currently 
modifiable. Inherited from Changeable. 

Gets or sets a Boolean that determines whether the segment is 
stroked. Inherited from PathSegment. 

Gets or sets a UseStatus enumeration that specifies how the 
Changeable object behaves when it is "used." A Changeable object 
is considered used in the following situations: the object is set into a 
Property System property, the object is used as a sub-object in a 
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complex Changeable object, or the object is used in a 
DrawingContext command. Inherited from Changeable. 

UlContext Gets the UIContext of the current object. The UlContext is used for 

maintaining thread safety. Inherited from Changeable. 



PrintContext Class 

Definition: PrintContext holds state and context for a printer interation 

Method Description 

Add a visual as the last page 
Dispose cleans up the state associated 

Determines whether two Object instances are equal. Inherited from Object. 
Finalizer for ImageData 

Serves as a hash function for a particular type, suitable for use in hashing 
algorithms and data structures like a hash table. Inherited from Object. 
Gets the Type of the current instance. Inherited from Object. 
Creates a shallow copy of the current Object. Inherited from Object. 
Print current job 
Connect to default printer 

Determines whether the specified Object instances are the same 
instance. Inherited from Object. 

SelectPrintQueue 

Associates this UlContextObject with a UlContext. Inherited from UlContextObject. 
Returns a String that represents the current Object. Inherited from Object. 



Property Description 

PnntPYt Returns the UlContext that this UlContextObject is associated with. Inherited from 
uumexi UlContextObject. 

JobTicket JobTicket property 
Output Output property 

This example demonstrates how to use a PrintContext object to write to a printer. 
The following code demonstrates how to print a Visual (the VectorPage in this example) to the default 
printer. The VectorPage in this example derives from DrawingVisual and is used to draw several shapes. 
Two VectorPage objects are printed by calling the AddPage method twice. 
[C#] 

public static void PrintPaginatedVisualToDefaultPrinter() { 
// create a print context for my default printer 
MSAvalon.Windows. Media. PrintContext pc = 
new MSAvalon.Windows.Media.PrintContext(); 

// Add two pages to the default rendition 
pc.AddPage(new VectorPage()); 
pc.AddPage(new VectorPage()); 

//Print 
pc.Print(); 

} 



AddPage 
Dispose 
Equals 
Finalize 

GetHashCode 

GetType 

MemberwiseClone 
Print 

PrintContext 

ReferenceEquals 

SelectPrintQueue 
SetContext 

ToString 
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The next example demonstrates how to print a Visual to a printer that the user selects. The 
SelectPrintQueue method is used to produce a dialog box that enables the user to select the printer, 
number of copies to print, and other options. 
[C#] 

public static void PrintPaginatedVisualToSelectedPrinter() { 
// Let user select a printer queue using common dialog box 
System. Printing.PrintSubSystem.PrintQueue queue = 
MSAvalon.Windows.Media.PrintContext.SelectPrintQueue(); 

if (queue != null) { 

// Create MSAvalon.Windows.Media.PrintContext if OK button was clicked 
MSAvalon. Windows. Media. PrintContext pc = 
new MSAvalon.Windows.Media.PrintContext(queue, "Printing Example"); 

// Add a page of visual 
pc.AddPage(new VectorPage()); 

// Print 
pc.PrintO; 

} 

} 

The next example demonstrates how to print to landscape and portrait page orientations. In the following 
code, a JobTicket is obtained and used to set the page orientation. The DimensionPage in this example is 
a DrawingVisuai that adjust the size of its drawing to the size of the output page. The 
GetPaperWidthHeight method in this example is used to retrieve the page size information from the 
JobTicket. 
[C#] 

public static void MixedOrientationPrint() { 
System. Printing. PrintSubSystem.LocalPrintServer ps = 
new System. Printing. PrintSubSystem.LocalPrintServer(); 

System.Printing.PrintSubSystem.PrintQueue queue = ps.DefaultPrintQueue; 

MSAvalon.Windows.Media. PrintContext pc = 

new MSAvalon.Windows.Media.PrintContext(queue, "Landscape Example"); 

Microsoft.Printing. JobTicket. JobTicket jt = pc. JobTicket; 

// Print a page with landscape orientation. 
{ 

jt.PageOrientation. Value = 
System.Printing.Configuration.PrintSchema.OrientationValues.Landscape; 

double width, height; 

GetPaperWidthHeight(pc.JobTicket, queue, out width, out height); 
// Add a page of visual 

pc.AddPage(new DimensionPage(height, width)); 

} 
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// Print a page with portrait orientation. 
{ 

jt.PageOrientation. Value = 
System.Printing.Configuration.PrintSchema.OrientationValues.Portrait; 

double width, height; 

GetPaperWidthHeight(pcJobTicket, queue, out width, out height); 
// Add a page of visual 

pc.AddPage(new DimensionPage(width, height)); 

} 

// Print 
pc.Print(); 

} 

internal static void GetPaperWidthHeight(Microsoft.PrintingJobTicket.JobTicket jt, 

System. Printing. PrintSubSystem.PrintQueue pq, out double width, out double height) { 

Microsoft.Printing.DeviceCapabilities.DeviceCapabilities devcap = 
new Microsoft. Printing . DeviceCapabilities. DeviceCapabilities( 
pq.AcquireDeviceCapabilities(null)); 

devcap. LengthUnitType = System. Printing. Configuration. PrintSchema.LengthUnitTypes.lnch; 

width = (double) devcap.PageCanvasSizeCap.CanvasSizeX * 96; 
height = (double) devcap. PageCanvasSizeCap.CanvasSizeY * 96; 

} 



The next example demonstrates how to print based on the GetPage event. The GeneratePage method is 
used to handle the event. 
[C#] 

public static void EventDriven() { 
System. Printing. PrintSubSystem.LocalPrintServer ps = 
new System. Printing. PrintSubSystem.LocalPrintServer(); 

System.Printing.PrintSubSystem.PrintQueue queue = ps.DefaultPrintQueue; 

// Create MSAvalon.Windows.Media.PrintContext if OK button was clicked 
MSAvalon.Windows.Media.PrintContext pc = 

new MSAvalon.Windows.Media.PrintContext(queue, "EventDriven(2 pages)"); 
pc.GetPage += new MSAvalon.Windows.Media.PrintContext.GetPageEventHandler(GetAPage); 

// Print 
pc.PrintO; 

} 

private static MSAvalon.Windows.Media. Visual GeneratePage(object sender, 
int pageNo, MSAvalon.Windows.Media. GetPageEventArgs ev) { 

if (pageNo == 0) { 
return new VectorPageQ; 



223 



} 

else if (pageNo == 1) { 
return new ImagePageQ; 

} 

else return null; 

} 

When running the sample and performing this operation, a dialog box with an assertion error message 
may appear. Click the Ignore All button to ignore the assertion and print the pages. 
The final example shows how to print to a file by using the PrintContext object's Output property. 
[C#] 

public static void PrintToFile() { 
System.Printing.PrintSubSystem.LocalPrintServer ps = 
new System.Printing.PrintSubSystem.LocalPrintServer(); 

System. Printing. PrintSubSystem.PrintQueue queue = ps.DefaultPrintQueue; 

// Create PrintContext if OK button was clicked 
MSAvalon.Windows.Media. PrintContext pc = 
new MSAvalon.Windows.Media.PrintContext(queue, "PrintToFile"); 

pc.Output = "testprn"; 

// Add a page of visual 
pc.AddPage(new VectorPageQ); 

// Print 
pc.Print(); 

} 

This example demonstrates how to use a PrintContext object to print a rendered "Longhorn" markup 
language (code-named "XAML") file. 

In the following example, the LoadContent method is used to load, parse, and return a "XAML" file's root 
UlElement. The UlElement, page, is then configured with a LayoutManager, added to the PrintContext 
object using the AddPage method, and printed with the Print method. 
[C#] 

public static void PrintXamlFile(string xamlFilePath) { 
// Let user select a printer queue using common dialog box 
System.Printing. PrintSubSystem.PrintQueue queue = 
MSAvalon.Windows.Media.PrintContext.SelectPrintQueue(); 

if (queue != null) { 

MSAvalon.Windows.Media. PrintContext pc = 
new MSAvalon.Windows.Media.PrintContext(queue, "Element printing test"); 

MSAvalon.Windows.UIEIement page = LoadContent(xamlFilePath); 

MSAvalon. Windows. LayoutManager Im = new MSAvalon. Windows. LayoutManager(page); 

double width, height; 

GetPaperWidthHeight(pc. JobTicket, queue, out width, out height); 
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Im.Size = new MSAvalon.Windows.Size(width, height); 
lm.UpdateLayout(); 

pc.AddPage(page); 
pc.PrintO; 

} 

} 

The LoadContent method used in the previous example is used to load the "XAML" file, parse it, and 
return its root UlElement. The GetPaperWidthHeight method in this example is used to retrieve the page 
size information from the JobTicket 
[C#] 

public static MSAvalon.Windows.UIEIement LoadContent(string xamlFilePath) { 
System.lO.Stream xamlFileStream = System.lO.File.OpenRead(xamlFilePath); 
MSAvalon.Windows.UIEIement root = null; 
try{ 

MSAvalon.Windows.Serialization.ParserContext pc = 
new MSAvalon.Windows.Serialization.ParserContext(); 

System. Security. PermissionSet ps = 
MSAvalon.WindowsTrustManagementTrustManager.GetDefaultPermissionsO; 

System. Security. Permissions. FilelOPermission flop = 
new System. Security. Permissions. FilelOPermission( 
System. Security. Permissions. FilelOPermissionAccess.AIIAccess, 
System.lO.Path.GetFullPath( ,, .\\")); 

ps.AddPermission(fiop); 

root = 

(MSAvalon.Windows.UIEIement) MSAvalon.Windows.Serialization.Parser.LoadXml( 
xamlFileStream, null, pc, null, ps); 

} 

catch (Exception e) { 
Console.WriteLine("Load Failed:"); 
Console.WriteLine(e); 

} 

finally { 
// done with the stream 
xamlFileStream. Close(); 

} 

return root; 

} 



internal static void GetPaperWidthHeight(Microsoft.Printing. JobTicket. JobTicket jt, 

System. Printing. PrintSubSystem.PrintQueue pq, out double width, out double height) { 

Microsoft.Printing.DeviceCapabilities.DeviceCapabilities devcap = 
new Microsoft. Printing. DeviceCapabilities.DeviceCapabilities( 
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pq.AcquireDeviceCapabilities(null)); 



devcap. Length UnitType = System.Printing.ConfigurationPrintSchemaXengthUnitTypes.lnch; 

width = (double) devcap.PageCanvasSizeCap.CanvasSizeX * 96; 
height = (double) devcap. PageCanvasSizeCap.CanvasSizeY * 96; 

} 



QuadraticBezierSegment Class 

Definition: QuadraticBezierSegment 

Method 

CloneCore 
CloneCore 

CloneDownToUnchangeable 
Copy 

Copy 
Copy 

DisableCore 

EmbeddedAnimationCollectionReader 

EmbeddedAnimationCollectionWriter 

EmbeddedChangeableReader 

EmbeddedChangeableWriter 

EnableCore 

Equals 
Finalize 

GetCurrentValue 
GetCurrentValue 
GetCurrentValue 

GetHashCode 
GetType 

MakeUnchangeable 
MakeUnchangeableCore 



Description 

Returns a modifiable shallow or deep clone of the current object. 
This abstract method must be implemented by classes that 
derive from Changeable. Inherited from Changeable. 

Implementation of Animatable.CloneCore. 

Returns an immutable copy of the specified object. Inherited 
from Changeable. 

Creates a copy of this PathSegment. Inherited from 
PathSegment. 

Returns a modifiable copy of the current object. The copy's 
IsChangeable property is true and its StatusOfNextUse is 
Unchangeable. Inherited from Changeable. 

Creates a copy of this QuadraticBezierSegment. 

Inherited from PathSegment. 

Maybe this should be internal?? Inherited from Animatable. 
Inherited from Animatable. 
Inherited from Animatable. 
Inherited from Animatable. 
Inherited from PathSegment. 

Determines whether two Object instances are equal. Inherited 
from Object. 

Allows an Object to attempt to free resources and perform other 
cleanup operations before the Object is reclaimed by garbage 
collection. Inherited from Object. 

Returns a non-animated version of this GradientStop that 
represents its current state. Inherited from PathSegment. 

Returns a non-animated version of this Animatable that 
represents its current state. Inherited from Animatable. 

Returns a non-animated version of this QuadraticBezierSegment 
that represents its current state. 

Serves as a hash function for a particular type, suitable for use in 
hashing algorithms and data structures like a hash 
table. Inherited from Object. 

Gets the Type of the current instance. Inherited from Object. 

Makes an object immutable; after this method is called on a 
Changeable, its IsChangeable property is false. Inherited from 
Changeable. 

Implementation of MakeUnchangeableCore. Inherited from 
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MemberwiseClone 



ModifyHandlerlfChangeable 



OnChanged 

PropagateEventHandler 
QuadraticBezierSegment 

ReadPreamble 

ReferenceEquals 

SetDefaultParentTimeline 

SetDefaultParentTimelineCore 
ToString 

ValidateObjectState 
WritePostscript 

WritePreamble 



PathSegment. 

Creates a shallow copy of the current Object. Inherited from 
Object. 

Adds or removes a Changed event handler to or from the 
specified Changeable object, if the object is currently modifiable. 
If the specified object is not modifiable — if its IsChangeable 
property is false — this method has no effect. Inherited from 
Changeable. 

Called when the current object is modified. Classes that derive 
from Changed should call this method after they have been 
modified. Inherited from Changeable. 

Implementation of PropagateEventHandler. 

Ensures that simple (non-Changeable) members are being 
accessed from a valid Ul context. This method should be called 
before any simple members are accessed. Inherited from 
Changeable. 

Determines whether the specified Object instances are the same 
instance. Inherited from Object. 

This will change the time parent for animations on any of the 
properties of this Changeable which are inheriting their time 
parent Inherited from Animatable. 

Inherited from PathSegment. 

Returns a String that represents the current Object. Inherited 
from Object. 

Verifies that the current object has a valid state. If the object is in 
an invalid state, this method throws an exception. Inherited from 
Changeable. 

Causes the current object to validate itself and then invokes the 
OnChanged method. Inherited from Changeable. 

Ensures that simple (non-Changeable) members are being 
accessed from a valid user interface (Ul) context. This method 
should be called before any simple members are set. Inherited 
from Changeable. 



Property Description 

Used in conjunction with the ChangeableUsageOverride type sent in 

AllowChangeableReferenceOverride " 8 P aram <f r to ChangeableHelper.UseChangeable, to help 
a determine when a Changeable being put into "use" should be 

promoted to "ChangeableReference". Inherited from Changeable. 

True if this Changeable can be made unchangeable. Inherited from 
Changeable. 

The current parent Timeline associated with this Animatable. This 
will be the Timeline set to the ParentTimeline property of this 
Animatable if one has been set and if not, the Timeline last passed 
into the SetDefaultParentTimeline method. Inherited from 
Animatable. 



CanMakeUnchangeable 



DefaultParentTimeline 



HasAnimations 

IsAnimating 

IsChangeable 



Gets a Boolean that indicates whether the segment has animations. 



Gets a Boolean that indicates whether the object is currently 
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IsOverridingBaseValue 

IsStroked 

Pointl 

Pointl Animations 
Point2 

Point2Animations 



StatusOfNextUse 



UlContext 



modifiable. Inherited from Changeable. 

Gets or sets a Boolean that determines whether the segment is 
stroked. Inherited from PathSegment. 



Gets or sets a UseStatus enumeration that specifies how the 
Changeable object behaves when it is "used." A Changeable object 
is considered used in the following situations: the object is set into a 
Property System property, the object is used as a sub-object in a 
complex Changeable object, or the object is used in a 
DrawingContext command. Inherited from Changeable. 

Gets the UlContext of the current object. The UlContext is used for 
maintaining thread safety. Inherited from Changeable. 



RadialGradientBrush Class 

Definition: Defines a radial gradient used to fill an object. A focal point defines the beginning of the 
gradient, and a circle defines the end point of the gradient. 



Method 

AddStop 

CloneCore 

CloneCore 

CloneDownToUnchangeable 
Copy 



Copy 



Copy 



Copy 

DeserializeFrom 
DisableCore 

EmbeddedAnimationCollectionReader 
EmbeddedAnimationCollectionWriter 
EmbeddedChangeableReader 
EmbeddedChangeableWriter 



Description 

Adds a gradient stop to the brush. Inherited from GradientBrush. 
Returns a modifiable shallow or deep clone of the current object. 
This abstract method must be implemented by classes that 
derive from Changeable. Inherited from Changeable. 
Implementation of Animatable.CloneCore. 

Returns an immutable copy of the specified object. Inherited 
from Changeable. 

Returns a modifiable copy of the brush. The copy's 
IsChangeable property is true and its StatusOfNextUse is 
Unchangeable. Inherited from Brush. 

Returns a modifiable copy of the brush. The copy's 
IsChangeable property is true and its StatusOfNextUse is 
Unchangeable. 

Returns a modifiable copy of the brush. The copy's 
IsChangeable property is true and its StatusOfNextUse is 
Unchangeable. Inherited from GradientBrush. 

Returns a modifiable copy of the current object. The copy's 
IsChangeable property is true and its StatusOfNextUse is 
Unchangeable. Inherited from Changeable. 

Returns a new Brush initialized from the binary representation 
being read by the passed Binary Reader. Inherited from Brush. 
Inherited from GradientBrush. 

Maybe this should be internal?? Inherited from Animatable. 
Inherited from Animatable. 
Inherited from Animatable. 
Inherited from Animatable. 
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EnableCore 

Equals 

Finalize 

GetCurrentValue 
GetCurrentValue 

GetCurrentValue 

GetCurrentValue 
GetHasAnimations 

GetHashCode 

GetlsAn imating 

GetlsOverridingBaseValue 

GetType 

MakeUnchangeable 

MakeUnchangeableCore 
MemberwiseClone 

ModifyHandlerlfChangeable 



OnChanged 

PropagateEventHandler 
RadialGradientBrush 

ReadPreamble 

ReferenceEquals 
SerializeOn 

SetDefaultParentTimeline 
SetDefaultParentTimeline 



Inherited from GradientBrush. 

Determines whether two Object instances are equal. Inherited 
from Object. 

Inherited from Brush. 

Returns a non-animated version of this GradientBrush that 
represents its current state. Inherited from GradientBrush. 

Returns the current value of the brush. The returned brush has 
the same value as the current object, but doesn't vary over time. 
That is, the returned brush is a snapshot of the current object at 
the point in time at which this method was called. 

Returns the current value of the brush. The returned brush has 
the same value as the current object, but doesn't vary over time; 
that is, the returned brush is a snapshot of the current object at 
the point in time at which this method was called. Inherited from 
Brush. 

Returns a non-animated version of this Animatable that 
represents its current state. Inherited from Animatable. 

Inherited from Brush. 

Serves as a hash function for a particular type, suitable for use in 
hashing algorithms and data structures like a hash 
table. Inherited from Object. 

Inherited from Brush. 

Inherited from Brush. 

Gets the Type of the current instance. Inherited from Object. 

Makes an object immutable; after this method is called on a 
Changeable, its IsChangeable property is false. Inherited from 
Changeable. 

Inherited from GradientBrush. 

Creates a shallow copy of the current Object. Inherited from 
Object. 

Adds or removes a Changed event handler to or from the 
specified Changeable object, if the object is currently modifiable. 
If the specified object is not modifiable — if its IsChangeable 
property is false — this method has no effect. Inherited from 
Changeable. 

Called when the current object is modified. Classes that derive 
from Changed should call this method after they have been 
modified. Inherited from Changeable. 

Initializes a new instance of the RadialGradientBrush class. 

Ensures that simple (non-Changeable) members are being 
accessed from a valid Ul context. This method should be called 
before any simple members are accessed. Inherited from 
Changeable. 

Determines whether the specified Object instances are the same 
instance. Inherited from Object. 

Serialize this object using the passed writer Inherited from Brush. 
Inherited from Brush. 

This will change the time parent for animations on any of the 
properties of this Changeable which are inheriting their time 
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SetDefaultParentTimelineCore 
ToString 

ValidateObjectState 
WritePostscript 

WritePreamble 



parent. Inherited from Animatable. 
Inherited from GradientBrush. 

Returns a String that represents the current Object. Inherited 
from Object. 

Verifies that the current object has a valid state. If the object is in 
an invalid state, this method throws an exception. Inherited from 
Changeable. 

Causes the current object to validate itself and then invokes the 
OnChanged method. Inherited from Changeable. 

Ensures that simple (non-Changeable) members are being 
accessed from a valid user interface (Ul) context. This method 
should be called before any simple members are set. Inherited 
from Changeable. 



Property 



Description 

Used in conjunction with the ChangeableUsageOverride type sent in 



AllowChangeableReferenceOverride » a P aram€ fr to ChangeableHelper.UseChangeable, to help 
3 determine when a Changeable being put into use should be 



CanMakeUnchangeable 
Center 

CenterAnimations 



ColorlnterpolationMode 



DefaultParentTimeline 
Focus 

FocusAnimations 

GradientStops 

HasAnimations 
IsAnimating 

IsChangeable 

IsOverridingBaseValue 

MappingMode 

Opacity 

OpacityAn imations 



promoted to "ChangeableReference". Inherited from Changeable. 

True if this Changeable can be made unchangeable. Inherited from 
Changeable. 

Gets or sets the center of the outermost circle of the radial gradient. 

Gets or sets a collection of PointModifier objects that animate the 
brush's Center property. 

ColorlnterpolationMode - Read only accessor of the 
ColorlnterpolationMode property. This property controls how the 
colors in Gradient are interpolated. Default is 
ColorlnterpolationMode. Perceptually LinearGamma. Inherited from 
GradientBrush. 

The current parent Timeline associated with this Animatable. This 
will be the Timeline set to the ParentTimeline property of this 
Animatable if one has been set and if not, the Timeline last passed 
into the SetDefaultParentTimeline method. Inherited from 
Animatable. 

Gets or sets the location of the two-dimensional focal point that 
defines the beginning of the gradient. 

Gets or sets a collection of PointModifier objects that animate the 
brush's Focus property. 

Gets or sets the gradient stops (transition points) of a 
brush. Inherited from GradientBrush. 

Gets a Boolean that indicates whether the brush has animations. 

Gets a Boolean that indicates whether the object is currently 
modifiable. Inherited from Changeable. 

Gets or sets a BrushMappingMode enumeration that specifies 
whether the gradient brush's positioning coordinates are absolute or 
relative to the output area. Inherited from GradientBrush. 

Gets or sets the degree of opacity of a Brush. Inherited from Brush. 

Gets or sets the animations associated with the Opacity of the 
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brush. Inherited from Brush. 

RadjusX Gets or sets the horizontal radius of the outermost circle of the 

radial gradient 

RadiusXAnimations Gets or sets a col,ection of DoubleModifier objects that animate the 

brush's RadiusX property. 

RadiusY Gets or sets the vertical radius of the outermost circle of a radial 

gradient. 

RadiusYAnimations Gets or sets a co,,ection of DoubleModifier objects that animate the 

brush's RadiusY property. 

Gets or sets the type of spread method that specifies how to draw a 
SpreadMethod gradient that starts or ends inside the bounds of the object to be 

painted. Inherited from GradientBrush. 

Gets or sets a UseStatus enumeration that specifies how the 
Changeable object behaves when it is "used." A Changeable object 

StatusOfNextUse is considered used in the following situations: the object is set into a 

Property System property, the object is used as a sub-object in a 
complex Changeable object, or the object is used in a 
DrawingContext command. Inherited from Changeable. 
Gets or sets a transformation that is applied to the brush. This 

Transform transformation is applied after all other mapping and positioning 

have been processed. Inherited from Brush. 

UlContext Gets the u,Context of the current object. The UlContext is used for 

maintaining thread safety. Inherited from Changeable. 

The RadialGradientBrush is similar in programming model to the LinearGradientBrush. However, the 
linear gradient has a start and end point to define the gradient vector, while the radial gradient has a circle 
along with a focal point to define the gradient behavior. The circle defines the end point of the gradient. In 
other words, a gradient stop at 1.0 defines the color at the circle's circumference. The focal point defines 
the center of the gradient. A gradient stop at 0.0 defines the color at the focal point. 

The following image shows a rectangle filled with a radial gradient. The radial gradient that goes from 
white to grey. The outside circle represents the gradient circle while the red dot denotes the focal point. 
This gradient has its SpreadMethod set to Pad. 

This example demonstrates how to use the Transform property of brushes to apply transformations to 
LinearGradientBrush and RadialGradientBrush fills. A LinearGradientBrush is used to fill the first two 
Rectangle elements. The difference between the rectangles is that the LinearGradientBrush in the second 
rectangle is rotated 45 degrees. The second pair of rectangles illustrates the before and after effect of a 
ScaleTransform by reducing a RadialGradientBrush to half its normal height. 

<Border xmlns="http://schemas.microsoft.com/2003/xaml" 
Background="#CCCCCC"> 

<Canvas Height="40"> 

<!- Rectangle #1 is filled with a LinearGradientBrush. The gradient colors 
flow from left to right by default. --> 

<Rectangle RectangleLeft="10" RectangleTop="10" 
RectangleWidth="300" RectangleHeight="200"> 

<Rectangle.Fill> 
<LinearGradientBrush> 
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<LinearGradientBrush.GradientStops> 
<GradientStopCollection> 
<GradientStop Color="red" Offset="07> 
<GradientStop Color="yellow" Offset='T' /> 
<GradientStop Color= M blue M Offset= M 0.57> 
<GradientStop Color= n white" Offset="0.27> 
</GradientStopCollection> 
</LinearGradientBrush.GradientStops> 

</LinearGradientBrush> 
</Rectangle.Fill> 

</Rectangle> 



<!- Rectangle #2 is identical to the first rectangle except that the Transform 
property rotates the LinearGradientBrush so that the gradient colors are 
rotated by 45 degrees. -> 

<Rectangle RectangleLeft= M 320" RectangleTop="10" 
RectangleWidth="300 M RectangleHeight= ,, 200 M > 

<Rectangle.Fill> 
<LinearGradientBrush> 

<LinearGradientBrush.Transform> 

<RotateTransform Angle="45" /> <!-- Rotation angle. -> 
</LinearGradientBrush.Transform> 

<LinearGradientBrush.GradientStops> 
<GradientStopCollection> 
<GradientStop Color="red" Offset="0"/> 
<GradientStop Color="yellow" Offset= n 1" /> 
<GradientStop Color= n blue" Offset= M 0.57> 
<GradientStop Color="white n Offset="0.2'7> 
</GradientStopCollection> 
</LinearGradientBrush.GradientStops> 

</LinearGradientBrush> 
</Rectangle.Fill> 

</Rectangle> 



<!- Rectangle #3 is filled with a RadialGradientBrush. --> 

<Rectangle RectangleLeft="10" RectangleTop="250 n 
RectangleWidth= ,, 300 ,, RectangleHeight= ,, 200 ,, > 

<Rectangle.Fill> 
<RadialGradientBrush Focus="0.5,0.5"> 

<RadialGradientBrush.GradientStops> 
<GradientStopCollection> 
<GradientStop Color="red n Offeet="07> 
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<GradientStop Color^'yellow" Offset='T7> 
<GradientStop Color= M blue M Offset="0.57> 
</GradientStopCollection> 
</RadialGradientBrush.GradientStops> 

</RadialGradientBrush> 
</Rectangle.FiII> 

</Rectangle> 



<!- Rectangle #4 is identical to the third rectangle except that the Transform 
property applies a ScaleTransform to the RadialGradientBrush so that the 
gradient is half its previous height. -> 

<Rectangle RectangleLeft^^O" RectangleTop="250" 
RectangleWidth= ,, 300" RectangleHeight="200"> 

<Rectangle.Fill> 

<RadialGradientBrush Focus="0.5,0.5 M > 
<RadialGradientBrush.Transform> 

<ScaleTransform ScaleX="1 M ScaleY="0.5" /><!-- Scale transform. -> 
</RadialGradientBrush.Transform> 

<RadialGradientBrush.GradientStops> 
<GradientStopCollection> 
<GradientStop Coloured" Offset="07> 
<GradientStop Color="yellow" 0ffset="17> 
<GradientStop Color^'blue" Offset="0.57> 
</GradientStopCollection> 
</RadialGradientBrush.GradientStops> 

</RadialGradientBrush> 
</Rectangle.Fill> 

</Rectangle> 

</Canvas> 
</Border> 

This example creates simple vertical, horizontal, and radial gradients and uses them to fill an element 
using "Longhorn" markup language (code-named "XAML"). 

In the following example, vertical and horizontal gradients are used to set the Fill property of two 
Rectangle elements. In this particular example, the gradients are described using simple notation: 
GradientType StartColor EndColor, where GradientType is VerticalGradient, HorizontalGradient, or 
RadialGradient. StartColor and EndColor can be predefined color names (such as Blue) or hexadecimal 
values. 

<Canvas xmlns= M http://schemas.microsoft.com/2003/xamr , > 

<Rectangle 
Fill="VerticalGradient Blue Green" 
RectangleLeft= n 20 M 
RectangleTop="20" 
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RectangleWidth="100" 
RectangleHeight="100"> 
</Rectangle> 

<Rectangle 

Fill="HorizontalGradient Blue Red" 
RectangleLeft="120" 
RectangleTop="120" 
RectangleWidth="100" 
RectangleHeight="100"> 
</Rectangle> 

A vertical gradient is a linear gradient whose start and endpoints form a vertical line; likewise, a horizontal 
gradient is a linear gradient whose start and endpoints form a horizontal line. You can explicitly describe 
your own linear gradients using the following syntax: 

LinearGradient StartPoint EndPoint StartColor EndColor, where StartPoint and EndPoint are the starting 
and ending coordinates, with each coordinate expressed as a pair of x and y values from 0 to 1, such as 
0.1,0.1 and 0.5,0.5. These values indicate the relative position of the start or end point. An endpoint of 
0.5,0.5 would be located 50 percent to the right of the fill area and 50 percent of the way from the top of 
the area— the middle of the shape. 

In the following example, the Fill property of a Rectangle element is set by explicitly using a linear 
gradient. 

<Rectangle 

Fill= M LinearGradient 0.1,0.1 0.5,0.5 Blue Green" 
RectangleLeft="220" 
RectangleTop="220" 
RectangleWidth="100" 
RectangleHeight="100"> 
</Rectangle> 

In the final example, the Fill property of a Rectangle element is set using a radial gradient. 

<Rectangle 

Fill="RadialGradient Blue Red" 

RectangleLeft="320" 

RectangleTop="320" 

RectangleWidth="100" 

RectangleHeight="100"> 
</Rectangle> 

</Canvas> 

See Create a Gradient with More Than Two Colors for an example of how to create a gradient with more 
than two gradient stops. 

To create vertical and horizontal gradients in code or using compound notation, use the 
LinearGradientBrush class and set its StartPoint and EndPoint properties so that they describe a vertical 
or horizontal line. To create radial gradients in code or using compound notation, use the 
RadialGradientBrush class. 

This example demonstrates how to create a gradient that has more than two colors in "XAML". To create 
a gradient with more than two colors, add a GradientStopCollection to the gradient's GradientStops 
property. Next, add GradientStop objects to the GradientStopCollection, one for each color the gradient 
should contain. Set the Color and the Offset, a value from 0 to 1 that determines the relative position of 
the stop in the gradient, of each of the stops. The following example shows a Button whose Background 
is filled with a horizontal gradient that has four colors. 

<Canvas ID="root" 
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xmlns= ,, http://schemas.microsoft.com/2003/xaml n > 
<Button 

Canvas.Top="50 n 
Canvas. Left= M 50" 
BorderBrush="Black" 
Width="200" 
Height="30"> 
<Button.Background> 
<LinearGradientBrush > 
<LinearGradientBrush.GradientStops> 
<GradientStopCollection> 
<GradientStop Color= M Red" Offset="0 M /> 
<GradientStop Color="Blue" Offset="0.257> 
<GradientStop Color= M Orange" Offset= M 0.757> 
<GradientStop Color="Yellow n Offset=*TY> 
</GradientStopCollection> 
</LinearGradientBrush.GradientStops> 
</LinearGradientBrush> 
</Button.Background> 
</Button> 

</Canvas> 



RectangleGeometry Class 

Definition: Represents the geometry of a rectangle. 



Method 



CloneCore 



CloneCore 

CloneDownToUnchangeable 

Copy 

Copy 
Copy 

DisableCore 

Dispose 

DoesContain 

EmbeddedAnimationCollectionReader 

EmbeddedAnimationCollectionWriter 

EmbeddedChangeableReader 

EmbeddedChangeableWriter 

EnableCore 

Equals 



Description 

Returns a modifiable shallow or deep clone of the current object. 
This abstract method must be implemented by classes that derive 
from Changeable. Inherited from Changeable. 

Implementation of Animatable.CloneCore. 

Returns an immutable copy of the specified object. Inherited from 
Changeable. 

Returns a modifiable copy of the current object. The copy's 
IsChangeable property is true and its StatusOfNextUse is 
Unchangeable. Inherited from Changeable. 

Creates a copy of this Geometry. Inherited from Geometry. 

Creates a copy of this RectangleGeometry. 

Inherited from Geometry. 

Releases the resources associated with the object. Inherited from 
Geometry. 

Returns if point is inside the geometry. Inherited from Geometry. 
Maybe this should be internal?? Inherited from Animatable. 
Inherited from Animatable. 
Inherited from Animatable. 
Inherited from Animatable. 
Inherited from Geometry. 

Determines whether two Object instances are equal. Inherited 
from Object. 
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Finalize 
GetBounds 

GetCurrentValue 

GetCurrentValue 

GetHashCode 
GetType 

MakeUnchangeable 

MakeUnchangeableCore 
MemberwiseClone 

ModifyHandlerlfChangeable 
OnChanged 

PropagateEventHandler 

ReadPreamble 

RectangleGeometry 
ReferenceEquals 

SetDefaultParentTimeline 

SetDefaultParentTimelineCore 
ToString 

ValidateObjectState 
WritePostscript 

WritePreamble 



Inherited from Geometry. 

Returns the bounds of a Geometry, widened according to the 
characteristics of the specified pen. Inherited from Geometry. 

Returns a non-animated version of this Animatable that represents 
its current state. Inherited from Animatable. 

Returns a non-animated version of this Geometry that represents 
its current state. Inherited from Geometry. 

Serves as a hash function for a particular type, suitable for use in 
hashing algorithms and data structures like a hash table. Inherited 
from Object. 

Gets the Type of the current instance. Inherited from Object. 

Makes an object immutable; after this method is called on a 
Changeable, its IsChangeable property is false. Inherited from 
Changeable. 

Inherited from Geometry. 

Creates a shallow copy of the current Object. Inherited from 
Object. 

Adds or removes a Changed event handler to or from the 
specified Changeable object, if the object is currently modifiable. If 
the specified object is not modifiable — if its IsChangeable property 
is false — this method has no effect. Inherited from Changeable. 

Called when the current object is modified. Classes that derive 
from Changed should call this method after they have been 
modified. Inherited from Changeable. 

Implementation of PropagateEventHandler. 

Ensures that simple (non-Changeable) members are being 
accessed from a valid Ul context. This method should be called 
before any simple members are accessed. Inherited from 
Changeable. 

Initializes a new instance of the RectangleGeometry class. 

Determines whether the specified Object instances are the same 
instance. Inherited from Object. 

This will change the time parent for animations on any of the 
properties of this Changeable which are inheriting their time 
parent. Inherited from Animatable. 

Inherited from Geometry. 

Returns a String that represents the current Object. Inherited from 
Object. 

Verifies that the current object has a valid state. If the object is in 
an invalid state, this method throws an exception. Inherited from 
Changeable. 

Causes the current object to validate itself and then invokes the 
OnChanged method. Inherited from Changeable. 

Ensures that simple (non-Changeable) members are being 
accessed from a valid user interface (Ul) context. This method 
should be called before any simple members are set. Inherited 
from Changeable. 



Property Description 

AllowChangeableReferenceOverride Used in conjunction with the ChangeableUsageOverride type sent in 
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Bounds 

CanMakeUnchangeable 

DefaultParentTimeline 

HasAnimations 

IsAnimating 

IsChangeable 

IsOverridingBaseValue 

RadiusX 

RadiusXAnimations 
RadiusY 

RadiusYAnimations 
Rect 

RectAnimations 

StatusOfNextUse 

Transform 
UlContext 



as a parameter to ChangeableHelper.UseChangeable, to help 
determine when a Changeable being put into "use" should be 
promoted to "ChangeableReference". Inherited from Changeable. 
Gets a Rect that specifies the bounding box of a 
RectangleGeometry. This method does not take any pens into 
account. 

True if this Changeable can be made unchangeable. Inherited from 
Changeable. 

The current parent Timeline associated with this Animatable. This 
will be the Timeline set to the ParentTimeline property of this 
Animatable if one has been set and if not, the Timeline last passed 
into the SetDefaultParentTimeline method. Inherited from 
Animatable. 

Gets a Boolean that indicates whether the geometry has 
animations. 

Returns true if the geometry contains active animations. 

Gets a Boolean that indicates whether the object is currently 
modifiable. Inherited from Changeable. 

Gets or sets the radius of the rounded corner where it connects with 
the upper and lower edges of the rectangle. 

Gets or sets a collection of DoubleModifier objects that animate the 
geometry's RadiusX property. 

Gets or sets the radius of the rounded corner where it connects with 
the left and right edges of the rectangle. 

Gets or sets a collection of DoubleModifier objects that animate the 
geometry's RadiusY property. 

Gets or sets the dimensions of the rectangle. 

Gets or sets a collection of RectModifier objects that animate the 
rectangle's dimensions. 

Gets or sets a UseStatus enumeration that specifies how the 
Changeable object behaves when it is "used." A Changeable object 
is considered used in the following situations: the object is set into a 
Property System property, the object is used as a sub-object in a 
complex Changeable object, or the object is used in a 
DrawingContext command. Inherited from Changeable. 

Gets or sets the Transform object applied to a Geometry. Inherited 
from Geometry. 

Gets the UlContext of the current object. The UlContext is used for 
maintaining thread safety. Inherited from Changeable. 



This example demonstrates how to draw shapes using the Geometry, PathFigure, and PathSegment 
classes. In this example, several shapes are drawn using Geometry objects and are displayed using a 
Path element. 



There is a Geometry class for each basic geometric shape: LineGeometry, EllipseGeometry, and 
RectangleGeometry. Complex shapes, such as polygons and shapes with curved segments, may be 
created using a PathGeometry. 

In the following example, a LineGeometry, EllipseGeometry, and a RectangleGeometry object are used to 
create a line, an ellipse, and a rectangle. 
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//c# 

MSAvalon.Windows. Media. LineGeometry myLineGeometry = 
new LineGeometry(new Point(50, 50), new Point(300, 50)); 

MSAvalon.Windows. Media. EllipseGeometry myEllipseGeometry = 
new EllipseGeometry(new Point(440 t 100), 40, 75); 

MSAvalon.Windows. Media. RectangleGeometry myRectangleGeometry = 
new RectangleGeometry(new Rect(new Point(400, 225), new Size(100, 50))); 

•VB.NET 

Dim myLineGeometry As new MSAvalon.Windows.Media.LineGeometry( _ 
new MSAvalon.Windows. Point(50, 50), new MSAvalon.Windows. Point(300, 50)) 

Dim myEllipseGeometry As new MSAvalon. Windows. Media. EllipseGeometry( _ 
new MSAvalon.Windows.Point(440, 100), 40, 75) 

Dim myRectangleGeometry As new MSAvalon.Windows.Media.RectangleGeometry( 
new MSAvalon.Windows. Rect(new MSAvalon.Windows.Point(400,225), _ 
new MSAvalon.Windows.Size(100,50))) 



PathGeometry objects can be used to create complex shapes, such as arcs and curves. PathGeometry 
objects are comprised of one or more PathFigure objects; each PathFigure represents a different "figure" 
or shape. Each PathFigure is itself comprised of one or more PathSegment objects, each representing a 
connected portion of the figure or shape. Segment types include the following: LineSegment, 
BezierSegment, and ArcSegment. 

In the following code, a PathGeometry and a PathFigure are created, and several segments are added to 
the PathFigure to form a shape. There are several ways to add segments to a PathFigure; you can use 
the PathFigure object's "draw segment" commands to automatically create new segments and add them 
to the figure, or you can explicitly create segments and add them manually using the PathFigure object's 
Segments property or AddSegment method. This example shows both ways of adding segments to a 
figure. 

The first segment of a PathFigure must be a StartSegment. The StartSegment may be added by creating 
a new StartSegment and adding it to the PathFigure, or it can be added using the PathFigure object's 
StartAt method. The following code demonstrates adding a StartSegment using the StartAt method. The 
start point is set to (200,50). 

II C# 

MSAvalon.Windows. Media. PathGeometry my PathGeometry = new PathGeometry (); 
MSAvalon.Windows. Media. PathFigure myPathFigure = new PathFigure(); 

// PathFigure objects must have a defined start point before 
// other segments can be added. 
myPathFigure.StartAt(new Point(200,50)); 

'VB.NET 

Dim myPathGeometry As new MSAvalon.Windows.Media.PathGeometry() 
Dim myPathFigure As new MSAvalon.Windows.Media.PathFigureQ 

' PathFigure objects must have a defined start point before 
' other segments can be added. 

myPathFigure.StartAt(new MSAvalon.Windows. Point(200,50)) 

In the following code, the BezierTo method is used to create three Bezier curves. A fourth curve is 
created by explicitly creating a BezierSegment and adding it to myPathFigure using the AddSegment 
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method. After the segments are added to the PathFigure (myPathFigure), the PathFigure is added to the 
PathGeometry. 
//C# 

myPathFigure. BezierTo( 
new Point(400, 100), new Point(400, 200), new Point(200, 300)); 

myPathFigure. BezierTo( 
new Point(400, 300), new Point(400, 100), new Point(200, 50)); 

myPathFigure.BezierTo( 

new Point(0, 100), new Point(0, 200), new Point(200,300)); 

MSAvalon.Windows.Media.BezierSegment myBezierSegment = 
new BezierSegment(new Point(0, 300), new Point(0, 100), new Point(200, 50), true); 

myPathFigure.AddSegment(myBezierSegment); 

myPathGeometry.Figures.Add(myPathFigure); 

•VB.NET 

myPathFigure.BezierTo(new MSAvalon. Windows. Point(400, 100), _ 
new MSAvalon.Windows.Point(400, 200), new MSAvalon. Windows. Point(200, 300)) 

myPathFigure. BezierTo(new MSA valon. Windows. Point(400, 300), _ 
new MSAvalon. Windows. Point(400, 100), new MSAvalon. Windows. Point(200, 50)) 

myPathFigure. BezierTo(new MSAvalon. Windows. Point(0, 100), _ 
new MSAvalon. Windows. Point(0, 200), new MSAvalon.Windows.Point(200,300)) 

Dim myBezierSegment As new BezierSegment( _ 
new MSAvalon. Windows. Point(0, 300), new MSAvalon.Windows.Point(0, 100), _ 
new MSAvalon. Windows. Point(200, 50), true) 

myPathFigure.AddSegment(myBezierSegment) 

' Add the PathFigure to the PathGeometry 
myPathGeometry.Figures.Add(myPathFigure) 

In the final code example, the geometries are added to a GeometryCollection, and the 
GeometryCollection is used to set the Path element's Data property. Had there been only one geometry, 
it could have been used to set the Data property directly, without the GeometryCollection. 
// C# 

GeometryCollection myGeometryCollection = new GeometryCollection(); 
myGeometryCollection.Add(myLineGeometry); 
myGeometryCollection. Add(myEllipseGeometry); 
myGeometryCollection.Add(myRectangleGeometry); 
myGeometryCollection.Add(myPathGeometry); 

Path myPath = new Path(); 
myPath.Data = myGeometryCollection; 

// Set the outline and the fill of the Path element. 

myPath. Stroke = Brushes. Blue; 

myPath.StrokeThickness = new Length(5); 

SolidColorBrush solidFill = new SolidColorBrushQ; 

myPath. Fill = new RadialGradientBrush(Colors.Orange, Colors.Red); 
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// Add the Path element to a Canvas. 
myCanvas.Children.Add(myPath); 

'VB.NET 

Dim myGeometryCol lection As new MSAvalon.Windows.Media.GeometryCollection() 

myGeometryCoHection.Add(myLineGeometry) 

myGeometryCollection.Add(myEllipseGeometry) 

myGeometryCollection.Add(myRectangleGeometry) 

myGeometryCollection.Add(myPathGeometry) 

Dim myPath As new Path() 
myPath.Data = myGeometryCollection 

1 Set the outline and the fill of the Path element. 
myPath. Stroke = MSAvalon.Windows.Media. Brushes. Blue 
myPath.StrokeThickness = new MSAvalon. Windows. Length(5) 
Dim solidFill As new MSAvalon.Windows.Media. SolidColorBrush() 
myPath. Fill = new RadialGradientBrush(MSAvalon.Windows.Media.Colors.Orange, _ 
MSAvalon.Windows.Media.Colors.Red) 

' Add the Path element to a Canvas. 
myCanvas.Children.Add(myPath) 

Geometry objects may also be rendered using the DrawingContext, which supplies a DrawGeometry 
method that may be used to render Geometry objects. Geometry objects may also be used for clipping 
and hit-testing. 

This example demonstrates how to draw shapes using the Geometry and Path elements in "Longhorn" 
markup language (code-named "XAML"). 

In the following example, a Path is drawn on a Canvas. Several Geometry elements are assigned to the 
Path element's Data attribute. 
<Canvas ID="root" 
Background="White" 

xmlns="http://schemas.microsoft.com/2003/xaml"> 



<Path ID= M myPath" 
Fill="Blue M 
Stroke="Black" 
StrokeThickness="5"> 

<Path.Data> 
<GeometryCollection> 

<LineGeometry StartPoint= H 50,50 n EndPoint="300,507> 
<EllipseGeometry Center="440, 100" RadiusX="40 M RadiusY='757> 

<RectangleGeometry > 
<RectangleGeometry.Rect> 

<Rect X="400 , ' Y="225" Width="100" Height="50'7> 
</RectangleGeometry. Rect> 
</RectangleGeometry> 

<PathGeometry> 
<PathGeometry.Figures> 
<PathFigureCollection> 
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<PathFigure> 
<PathFigure.Segments> 
<PathSegmentCollection> 
<StartSegment Point="400,1007> 

<BezierSegment Pointl ="400,100" Point2="400,200" Point3="200,3007> 
<BezierSegment Pointl ="400,300" Point2="400,100" Point3="200,507> 
<BezierSegment Pointl ="0,1 00" Point2="0,200" Point3="200,3007> 
<BezierSegment Pointl ="0,300" Point2="0,100" Point3="200,507> 
</PathSegmentCollection> 
</PathFigure.Segments> 
</PathFigure> 
</PathFigureCollection> 
</PathGeometry.Figures> 
</PathGeometry> 



</GeometryCollection> 

</Path.Data> 
</Path> 



</Canvas> 

In the previous example, the PathFigure object, one of the shapes drawn inside the Path element, 
contains a StartSegment but no CloseSegment; if a CloseSegment were added to the figure, a line would 
be drawn from the last segment in the collection back to the starting point of the figure. 



RetainedVisual Class 

Definition: RetainedVisual 

Method 



ClearValue 

Equals 

Finalize 

GetHashCode 

GetLocalValueEnumerator 

GetType 

GetValue 

HitTestCore 

InvalidateProperty 

InvalidateVisual 

IVisual.FindCommonVisualAncestor 
I Visual. HitTest 
IVisual.lsAncestorOf 



Description 

Clears the local value of a property Inherited from 
DependencyObject. 

Determines whether two Object instances are equal. Inherited 
from Object. 

Releases all resources held by the Visual object. Inherited from 
Visual. 

Serves as a hash function for a particular type, suitable for use in 
hashing algorithms and data structures like a hash table. Inherited 
from Object. 

Create a local value enumerator for this instance Inherited from 
DependencyObject. 

Gets the Type of the current instance. Inherited from Object. 
Retrieve the value of a property Inherited from DependencyObject. 
HitTestCore implements precise hit testing against render contents 
Invalidates a property Inherited from DependencyObject. 
InvalidateVisual. 

Inherited from Visual. 

Inherited from Visual. 

Inherited from Visual. 
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I Visual. IsDescendantOf 

IVisual.TransformFromAncestor 

IVisualTransformFromDescendant 

IVisualTransformFromVisual 

IVisual.TransformToAncestor 

IVisual.TransformToDescendant 

IVisual.TransformToVisual 

MemberwiseClone 
OnDelayedlnvalidate 
OnPropertylnvalidated 
ReadLocalValue 

ReferenceEquals 

RenderOpen 
RetainedVisual 

SetContext 
SetValue 
ToString 
ValidateProperty 

ValidatePropertyCore 



Inherited from Visual. 
Inherited from Visual. 
Inherited from Visual. 
Inherited from Visual. 
Inherited from Visual. 
Inherited from Visual. 
Inherited from Visual. 

Creates a shallow copy of the current Object. Inherited from 
Object. 

TODO: Left over from WCP FastBuild, determine relevance in 
future version of FastBuild Inherited from DependencyObject. 

Notification that a specified property has been invalidated Inherited 
from DependencyObject. 

Retrieve the local value of a property (if set) Inherited from 
DependencyObject. 

Determines whether the specified Object instances are the same 
instance. Inherited from Object. 

RendeOpen opens the RetainedVisual for rendering. 

RetainedVisual ctor. 

Associates this UlContextObject with a UlContext. Inherited from 
UlContextObject. 

Sets the local value of a property Inherited from 
DependencyObject. 

Returns a String that represents the current Object. Inherited from 
Object. 

Retrieve the value of a property (for use by native cache backed 
custom get accessors) Inherited from DependencyObject. 

Allows subclasses to participate in property value 
computation Inherited from DependencyObject 



Property 



Context 



Description 

Returns the UlContext that this UlContextObject is associated with. Inherited 
from UlContextObject. 



nononHfinruOKiartTuno Returns the DType that represents the CLR type of this instance Inherited from 
uepenaencyuoject i ype Dependency0 bject 



HitTestBounds 



IsDisposed 



RenderBounds 



HitBounds returns the hit region bounding box for the current visual. Inherited 
from Visual. 

Gets a value that indicates whether the system has disposed of the 
Visual. Inherited from Visual. 

This property is only used if the RetainedVisual implements RetainedRender. If 
not this property will throw an InvalidOperationException. The implementer must 
set this property to the bounds of the ink drawn by his Render function in local 
coordinate space. 
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R tateTransform Class 

Definition: Used to rotate an object about a specified point in the two-dimensional x-y plane. 



Meth d 



CloneCore 



CloneCore 

CloneDownToUnchangeable 
Copy 

Copy 

Copy 

CreateMatrix 

CreateRotation 

CreateScale 

CreateSkew 

CreateTranslation 

DisableCore 

Dispose 

EmbeddedAnimationCollectionReader 

EmbeddedAnimationCollectionWriter 

EmbeddedChangeableReader 

EmbeddedChangeableWriter 

EnableCore 

Equals 

Finalize 

GetCurrentValue 

GetCurrentValue 

GetCurrentValue 
GetHasAnimations 

GetHashCode 



Description 

Returns a modifiable shallow or deep clone of the current object. 
This abstract method must be implemented by classes that 
derive from Changeable. Inherited from Changeable. 

Implementation of Animatable.CloneCore. 

Returns an immutable copy of the specified object. Inherited 
from Changeable. 

Creates a copy of this Transform. Inherited from Transform. 
Returns a modifiable copy of the current object. The copy's 
IsChangeable property is true and its StatusOfNextUse is 
Unchangeable. Inherited from Changeable. 
Creates a copy of this RotateTransform. 
Creates an arbitrary affine transformation matrix used for 
transformations in a two-dimensional plane. Inherited from 
Transform. 

Creates a transformation used for rotation in a two-dimensional 
plane. Inherited from Transform. 

Creates a transformation used for scaling in a two-dimensional 
plane. Inherited from Transform. 

Creates a transformation used for skewing in a two-dimensional 
plane. Inherited from Transform. 

Creates a transformation used for translating in the x- and y- 
directions in a two-dimensional plane. Inherited from Transform. 

Inherited from Transform. 

Dispose resources associated with transform. Inherited from 
Transform. 

Maybe this should be internal?? Inherited from Animatable. 
Inherited from Animatable. 
Inherited from Animatable. 
Inherited from Animatable. 
Inherited from Transform. 

Determines whether two Object instances are equal. Inherited 
from Object. 

Inherited from Transform. 

Creates a non-animated copy of this Transform with all of its 
base values set to the current animated values. Inherited from 
Transform. 

Returns a non-animated version of this RotateTransform that 
represents its current state. 

Returns a non-animated version of this Animatable that 
represents its current state. Inherited from Animatable. 
Inherited from Transform. 

Serves as a hash function for a particular type, suitable for use 

in hashing algorithms and data structures like a hash 

table. Inherited from Object. 
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GetlsAnimating 

GetlsOverridingBaseValue 

GetType 

MakeUnchangeable 

MakeUnchangeableCore 
MemberwiseClone 

ModifyHandlerlfChangeable 
OnChanged 

PropagateEventHandler 
ReadPreamble 

ReferenceEquals 
RotateTransform 

SetDefaultParentTimeline 

SetDefaultParentTimeline 
SetDefaultParentTimelineCore 

ToString 

ValidateObjectState 
WritePostscript 



WritePreamble 



Inherited from Transform. 
Inherited from Transform. 

Gets the Type of the current instance. Inherited from Object. 

Makes an object immutable; after this method is called on a 
Changeable, its IsChangeable property is false. Inherited from 
Changeable. 

Implementation of MakeUnchangeableCore. Inherited from 
Transform. 

Creates a shallow copy of the current Object. Inherited from 
Object. 

Adds or removes a Changed event handler to or from the 
specified Changeable object, if the object is currently modifiable. 
If the specified object is not modifiable — if its IsChangeable 
property is false — this method has no effect. Inherited from 
Changeable. 

Called when the current object is modified. Classes that derive 
from Changed should call this method after they have been 
modified. Inherited from Changeable. 

Ensures that simple (non-Changeable) members are being 
accessed from a valid Ul context. This method should be called 
before any simple members are accessed. Inherited from 
Changeable. 

Determines whether the specified Object instances are the 
same instance. Inherited from Object. 

Initializes a new instance of the RotateTransform class. The 
rotation angle is measured in degrees clockwise. The default 
center of rotation is the origin. 

This will change the time parent for animations on any of the 
properties of this Changeable which are inheriting their time 
parent. Inherited from Animatable. 

Inherited from Transform. 

Inherited from Transform. 

Not implemented. Use Object.ToString instead. Inherited from 
Transform. 

Verifies that the current object has a valid state. If the object is 
in an invalid state, this method throws an exception. Inherited 
from Changeable. 

Causes the current object to validate itself and then invokes the 
OnChanged method. Inherited from Changeable. 

Ensures that simple (non-Changeable) members are being 
accessed from a valid user interface (Ul) context. This method 
should be called before any simple members are set. Inherited 
from Changeable. 



Property Description 

Used in conjunction with the ChangeableUsageOverride type sent in 

Ai\n>,n^ nn ^\~B^r^^,*rriM~ as a parameter to ChangeableHelper.UseChangeable, to help 
AllowChangeableReferenceOvernde deter ^ jne when a changeable being put into "use" should be 

promoted to "ChangeableReference". Inherited from Changeable. 
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Gets or sets the angle of rotation, measured in degrees clockwise. 
Gets or sets a collection of DoubleModifier objects that animate the 
transformation's Angle property. 

True if this Changeable can be made unchangeable. Inherited from 
Changeable. 

Gets or sets the center point of rotation. 

Gets or sets a collection of PointModifier objects that animate the 
transformation's Center property. 

The current parent Timeline associated with this Animatable. This 
will be the Timeline set to the ParentTimeline property of this 
Animatable if one has been set and if not, the Timeline last passed 
into the SetDefaultParentTimeline method. Inherited from 
Animatable. 

Gets a Boolean that indicates whether the transformation has 
animations. 

Identity transformation. Inherited from Transform. 
Returns true if the transformation contains active animations. 
Gets a Boolean that indicates whether the object is currently 
modifiable. Inherited from Changeable. 

Gets or sets a UseStatus enumeration that specifies how the 
Changeable object behaves when it is "used." A Changeable object 
is considered used in the following situations: the object is set into a 
Property System property, the object is used as a sub-object in a 
complex Changeable object, or the object is used in a 
DrawingContext command. Inherited from Changeable. 
Gets the UlContext of the current object. The UlContext is used for 
maintaining thread safety. Inherited from Changeable. 
Gets the current rotation transformation as a Matrix object. 

This example in "Longhorn" markup language (code-named "XAML") shows how to create a spinning 
Rectangle. 

<DockPanel xmlns= ,, http://schemas.microsoft.com/2003/xaml"> 

<TransformDecorator> 
<TransformDecorator.Transform> 
<RotateTransform Center="1 00, 1 00"> 
<RotateTransform.AngleAnimations> 

<DoubleAnimation From="0" To="360" RepeatCount="30" Begin="1" 
Duration="4" /> 

</RotateTransform.AngleAnimations> 
</RotateTransform> 
<U ransformDecorator.Transform> 

<Rectangle RectangleTop="100" RectangleLeft="100" Fill="blue n 
RectangleWidth="50" RectangleHeight= n 50 n Stroke= M black" 
StrokeThickness="5" /> 

</TransformDecorator> 



Angle 

AngleAnimations 

CanMakeUnchangeable 
Center 

CenterAnimations 
DefaultParentTimeline 

HasAnimations 

Identity 
IsAnimating 

IsChangeable 

IsOverridingBaseValue 

StatusOfNextUse 

UlContext 
Value 
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</DockPanel> 



In the previous example, the DoubleAnimationCollection tag, <DoubleAnimationCollection>, is omitted 
when animating the transformation's angle. When animating a designated animation property— properties 
of the form PropertyNameAnimations, such as the AngleAnimations property in the previous example— 
you may omit the animation collection tag. However, when you animate a property of a Ul element— 
those classes that derive from UlElement— you must nest the animations within an animation collection 
tag. 

This example specifies rotation transforms on several shapes. The Transform class enables you to 
reposition and apply rendering changes to shape elements such as Rectangle, Polyline, and Ellipse. 
The RotateTransform class specifies a rotation of the coordinate system. By default, the coordinate 
system is rotated about (0,0), the default origin, by r degrees. The following code provides some 
examples of different rotations, some in conjunction with translation. 

<Canvas ID="root" 

xmlns= H http://schemas.microsoft.com/2003/xamr 
xmlns:def= M Definition ,, > 

<!- No transform --> 
<Polyline ID= n box1" 

Stroke="Black M 

StrokeThickness="5" 

Points="0,0 10,10 10,50 50,50 50,10 10,10" /> 

<!- Rotate about a set origin, then translate --> 
<Transform Decorator AffectsLayout="false"> 
<TransformDecorator.Transform> 
<TransformCollection> 

<RotateTransform Angle="90" /> 
<TranslateTransform X="100" Y="100" /> 

</TransformCollection> 
</TransformDecorator.Transform> 
<Polyline ID="box2" 

Stroke="Blue" 

StrokeThickness="5" 

Points="0,0 10,10 10,50 50,50 50,10 10,10"> 
</Polyline> 

</TransformDecorator> 

<Transform Decorator AffectsLayout="false"> 
<TransformDecorator.Transform> 
<TransformCollection> 

<RotateTransform Angle="-45" /> 
<TranslateTransform X="100 M Y^IOO" /> 

</TransformCollection> 
</TransformDecorator.Transform> 
<Polyline ID^boxS" 

Stroke= M Orange" 

StrokeThickness= M 5" 

Points="0,0 10,10 10,50 50,50 50,10 10,10"> 
</Polyline> 

</TransformDecorator> 
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<TransformDecorator AffectsLayout="false"> 
<TransformDecorator.Transform> 
<TransformCollection> 

<RotateTransform Angle="45" /> 
<TranslateTransform X= M 100" Y="100" /> 

</TransformCollection> 
</TransformDecorator.Transform> 
<Polyline ID="box4" 

Stroke="Green" 

StrokeThickness="5" 

Points="0,0 10,10 10,50 50,50 50,10 10,10"> 
</Polyline> 

</TransformDecorator> 

<!-- Translate, then rotate -> 
<Transform Decorator AffectsLayout="false"> 
<TransformDecorator.Transforrn> 
<TransformCollection> 

<TranslateTransform X="200" Y="200" /> 
<RotateTransform Angle="15 M /> 

</T ransformCollection> 
</Transform Decorator. Transform> 
<Polyline ID="box5" 

Stroke="Cyan" 

StrokeThickness= n 5 n 

Points="0,0 10,10 10,50 50,50 50,10 10,10"> 
</Polyline> 

</T ransformDecorator> 
</Canvas> 

When using rotation transformations, keep in mind that the transformation rotates the coordinate system 
for a particular element. This might apply effects that you should anticipate when working out the screen 
coordinates for elements. Depending on an element's position with respect to the origin, the effect of the 
rotation might not be to rotate it "in place." For an element positioned 200 units from 0 along the x-axis, 
for instance, a rotation of 30 degrees has the effect of swinging the element 30 degrees along a circle 
with radius 200, drawn around the origin. 

The Center attribute on the RotateTransform element allows you to set an origin about which the shape 
will be rotated. Note that in the preceding example, the start points of the blue, orange, and green 
Polyline elements are all located at (100,100) because the Center attribute of those elements is 
(100,100). The cyan Polyline, however, was rotated 15 degrees on an arc from (200,200) because its 
TranslateTransform was applied first. 

This example uses a RotateTransform object to rotate a Shape element. To scale an element, use a 
ScaleTransform object to specify the transformation, and a Transform Decorator object to apply the 
transformation. Instead of adding the element to the Canvas element or other Panel element, add the 
element as child of the TransformDecorator and add the Transform Decorator to the Panel. 

The RotateTransform object specifies a rotation of the coordinate system. By default, the coordinate 
system is rotated about (0,0), the default origin, by r degrees. The following code shows the two shapes. 
The first shape is not rotated. The second shape is rotated by 45 degrees around a RotateTransform of 
(1 10,1 10), the lower right corner of the shape. As a result, the shape appears as though it was rotated 
about its corner. 

//C# 

II Create a canvas to contain the shapes. 
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Canvas myCanvas = new Canvas(); 

// Create a PointCollection to contain the points of the Polygon shapes. 
PointCollection myPointCollection = new PointCollection(); 
myPointCollection.Add(new Point(60, 60)); 
myPointCollection.Add(new Point(70, 70)); 
myPointCollection. Add(new Point(70, 110)); 
myPointCollection. Add(new Point(110, 110)); 
myPointCollection. Add(new Point(110, 70)); 
myPointCollection.Add(new Point(70, 70)); 

// Create the first Polygon and add it to the Canvas. 
Polygon boxl = new PolygonQ; 
boxl Points = myPointCollection; 
box! Stroke = Brushes. Black; 
boxlStrokeThickness = new Length(5); 
myCanvas.Children. Add(box1 ); 

// Create the second Polygon. This polygon contains the same points as the 

// first, but is rotated. 

Polygon box2 = new Polygon(); 

box2. Points = myPointCollection; 

box2. Stroke = Brushes.Blue; 

box2.StrokeThickness = new Length(5); 

// Create a TransformDecorator to transform the shape. 
TransformDecorator transformer = new TransformDecorator(); 
transformer.AffectsLayout = false; 

// Create the rotation transformation. 

RotateTransform myRotateTransform = new RotateTransform(45, new Point(1 10,1 10)); 

// Set the TransformDecorator.Transform property. 
transformer.Transform = myRotateTransform; 

// Add box2 as a child of the TransformDecorator and add the TransformDecorator 
// to the Canvas. 
transformer.Child = box2; 
myCanvas.Children.Add(transformer); 



•VB.NET 

' Create a PointCollection to contain the points of the 
' Polygon shapes. 

Dim myPointCollection As MSAvalon.Windows.Media.PointCollection 
myPointCollection = new MSAvalon.Windows.Media. PointCollection 
myPointCollection. Add(new MSAvalon. Windows. Point(60, 60)) 
myPointCollection. Add(new MSAvalon. Windows. Point(70, 70)) 
myPointCollection.Add(new MSAvalon. Windows. Point(70, 110)) 
myPointCollection.Add(new MSAvalon. Windows. Point( 110, 110)) 
myPointCollection.Add(new MSAvalon.Windows.Point(1 10, 70)) 
myPointCollection. Add(new MSAvalon. Windows. Point(70, 70)) 

' Create the first Polygon and add it to the Canvas. 
Dim boxl As MSAvalon.Windows.Shapes.Polygon 
boxl = new MSAvalon. Windows.Shapes. Polygon 
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boxl Points = myPointCollection 
box! Stroke = Brushes.Black 

boxLStrokeThickness = new MSA valon. Windows. Length(5) 
myCanvas.Children. Add(box1 ) 

' Create the second Polygon. This polygon contains the same 

' points as the first, but is rotated. 

Dim box2 As MSAvalon.Windows.Shapes.Polygon 

box2 = new MSAvalon.Windows.Shapes. Polygon 

box2. Points = myPointCollection 

box2.Stroke = Brushes.Blue 

box2.StrokeThickness = new MSAvalon. Windows. Length(5) 

' Create a Transform Decorator to transform the shape. 
Dim transformer As MSAvalon.Windows.Controls.TransformDecorator 
transformer = new MSAvalon.Windows.Controls.TransformDecorator 
transformer.AffectsLayout = false 

' Create the scale transformation. 
Dim myRotateTransform As _ 

new MSAvalon.Windows.Media.RotateTransform(45, _ 
new MSAvalon. Windows. Point(1 1 0, 1 1 0)) 

'Set the TransformDecorator.Transform property 
transformer.Transform = myRotateTransform 

'Add box2 as a child of the TransformDecorator and add 
'the TransformDecorator to the Canvas. 
transformer.Child = box2 
myCanvas.Children.Add(transformer) 

When using rotation transformations, keep in mind that the transformation rotates the coordinate system 
for a particular element. This might apply effects that you should anticipate when working out the screen 
coordinates for elements. Depending on an element's position with respect to the origin, the effect of the 
rotation might not be to rotate it "in place." For example, for an element positioned 200 units from 0 along 
the x-axis a rotation of 30 degrees has the effect of swinging the element 30 degrees along a circle with 
radius 200, drawn around the origin. 

Although the previous example shows how to rotate a Shape element, the process is the same for other 
elements, including Button and Panel elements. 

ScaleTransform Class 

Definition: Scales an object in the two-dimensional x-y plane, starting from a defined center point. Scale 
factors are defined in x- and y-directions from this center point. 



Method 



Description 



Copy 



CloneDownToUnchangeable 



CloneCore 



CloneCore 



Returns a modifiable shallow or deep clone of the current object. 
This abstract method must be implemented by classes that derive 
from Changeable. Inherited from Changeable. 

Implementation of Animatable.CloneCore. 

Returns an immutable copy of the specified object. Inherited from 
Changeable. 

Creates a copy of this ScaleTransform. 
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Copy 
Copy 

CreateMatrix 

CreateRotation 

CreateScale 

CreateSkew 

CreateTranslation 

DisableCore 

Dispose 

EmbeddedAnimationCollectionReader 

EmbeddedAnimationCollectionWriter 

EmbeddedChangeableReader 

EmbeddedChangeableWriter 

EnableCore 

Equals 

Finalize 

GetCurrentValue 

GetCurrentValue 

GetCurrentValue 
GetHasAnimations 

GetHashCode 

GetlsAnimating 
GetlsOverridingBaseValue 
GetType 

MakeUnchangeable 

MakeUnchangeableCore 

MemberwiseClone 
ModifyHandlerlfChangeable 



Creates a copy of this Transform. Inherited from Transform. 

Returns a modifiable copy of the current object. The copy's 
IsChangeable property is true and its StatusOfNextUse is 
Unchangeable. Inherited from Changeable. 

Creates an arbitrary affine transformation matrix used for 
transformations in a two-dimensional plane. Inherited from 
Transform. 

Creates a transformation used for rotation in a two-dimensional 
plane. Inherited from Transform. 

Creates a transformation used for scaling in a two-dimensional 
plane. Inherited from Transform. 

Creates a transformation used for skewing in a two-dimensional 
plane. Inherited from Transform. 

Creates a transformation used for translating in the x- and y- 
directions in a two-dimensional plane. Inherited from Transform. 
Inherited from Transform. 

Dispose resources associated with transform. Inherited from 
Transform. 

Maybe this should be internal?? Inherited from Animatable. 
Inherited from Animatable. 
Inherited from Animatable. 
Inherited from Animatable. 
Inherited from Transform. 

Determines whether two Object instances are equal. Inherited from 
Object. 

Inherited from Transform. 

Returns a non-animated version of this ScaleTransform that 
represents its current state. 

Creates a non-animated copy of this Transform with all of its base 
values set to the current animated values. Inherited from 
Transform. 

Returns a non-animated version of this Animatable that represents 
its current state. Inherited from Animatable. 

Inherited from Transform. 

Serves as a hash function for a particular type, suitable for use in 
hashing algorithms and data structures like a hash table. Inherited 
from Object. 

Inherited from Transform. 
Inherited from Transform. 

Gets the Type of the current instance. Inherited from Object. 
Makes an object immutable; after this method is called on a 
Changeable, its IsChangeable property is false. Inherited from 
Changeable. 

Implementation of MakeUnchangeableCore. Inherited from 
Transform. 

Creates a shallow copy of the current Object. Inherited from 
Object. 

Adds or removes a Changed event handler to or from the specified 
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OnChanged 

PropagateEventHandler 
Read Preamble 

ReferenceEquals 
ScaleTransform 

SetDefaultParentTimeline 

SetDefaultParentTimeline 
SetDefaultParentTimelineCore 

ToString 

ValidateObjectState 
WritePostscript 

WritePreamble 



Changeable object, if the object is currently modifiable. If the 
specified object is not modifiable — if its IsChangeable property is 
false— this method has no effect. Inherited from Changeable. 
Called when the current object is modified. Classes that derive 
from Changed should call this method after they have been 
modified. Inherited from Changeable. 

Ensures that simple (non-Changeable) members are being 
accessed from a valid Ul context. This method should be called 
before any simple members are accessed. Inherited from 
Changeable. 

Determines whether the specified Object instances are the same 
instance. Inherited from Object. 

Initializes a new instance of the ScaleTransform class. 

This will change the time parent for animations on any of the 
properties of this Changeable which are inheriting their time 
parent. Inherited from Animatable. 

Inherited from Transform. 

Inherited from Transform. 

Not implemented. Use Object. ToString instead. Inherited from 
Transform. 

Verifies that the current object has a valid state. If the object is in 
an invalid state, this method throws an exception. Inherited from 
Changeable. 

Causes the current object to validate itself and then invokes the 
OnChanged method. Inherited from Changeable. 

Ensures that simple (non-Changeable) members are being 
accessed from a valid user interface (Ul) context. This method 
should be called before any simple members are set. Inherited 
from Changeable. 



Property Description 

Used in conjunction with the ChangeableUsageOverride type sent in 

AllowChangeableReferenceOverride ^ a P aram *er to ChangeableHelper.UseChangeable, to help 

determine when a Changeable being put into use should be 
promoted to "ChangeableReference". Inherited from Changeable. 

True if this Changeable can be made unchangeable. Inherited from 
Changeable. 

Gets or sets the center point of the scaling operation. Scale factors 
are defined in x- and y-directions from this center point. 

Gets or sets a collection of PointModifier objects that animate the 
transformation's Center property. 

The current parent Timeline associated with this Animatable. This 
will be the Timeline set to the ParentTimeline property of this 
Animatable if one has been set and if not, the Timeline last passed 
into the SetDefaultParentTimeline method. Inherited from 
Animatable. 



CanMakeUnchangeable 
Center 

CenterAnimations 

DefaultParentTimeline 

HasAnimations 
Identity 



Gets a Boolean that indicates whether the transformation has 
animations. 

Identity transformation. Inherited from Transform. 
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Returns true if the transformation contains active animations. 

Gets a Boolean that indicates whether the object is currently 
modifiable. Inherited from Changeable. 

Gets or sets the scale factor in the x-direction. 

Gets or sets a collection of DoubleModifier objects that animate the 
transformation's ScaleX property. 

Gets or sets the scale factor in the y-direction. 

Gets or sets a collection of DoubleModifier objects that animate the 
transformation's ScaleY property. 

Gets or sets a UseStatus enumeration that specifies how the 
Changeable object behaves when it is "used." A Changeable object 
is considered used in the following situations: the object is set into a 
Property System property, the object is used as a sub-object in a 
complex Changeable object, or the object is used in a 
DrawingContext command. Inherited from Changeable. 

Gets the UlContext of the current object. The UlContext is used for 
maintaining thread safety. Inherited from Changeable. 

Gets the current scaling transformation as a Matrix object. 

This example specifies scale transformations on several shapes. The ScaleTransform class enables you 
to reposition and apply rendering changes to shape elements like Rectangle, Polygon, and Ellipse. 
The ScaleX and ScaleY properties resize an element according to the factor you specify. For example, 
setting ScaleX to 1 .5 resizes the element's X-axis value at 1 50 percent. 

The following example demonstrates a polygon scaled in several ways. The first polygon (black) reflects 
no transformation. The second polygon (blue) is scaled at 50 percent in Y, and the third polygon (red) is 
scaled at 50 percent in X. Two of the polygons also include translation transformations for repositioning. 
Note that the scale transformation affects the element's stroke-thickness as well as its size. 

<Canvas ID="root" 

xmlns="http://schemas.microsoft.com/2003/xaml"> 

<!- No transform specified ~> 
<Polygon ID= ,, star1" 
Stroke="black" 
StrokeThickness="2.0" 

Points="1 76.5,50 1 89.2, 1 55. 003 286.485, 1 1 3.5 201 .9, 1 77 286.485,240.5 
189.2,198.997 176.5,304 163.8,198.997 66.5148,240.5 151.1,177 66.5148,113.5 
163.8,155.003"> 
</Polygon> 

<!- Scaled in Y --> 

<Transform Decorator Affects Layout- 'false"> 
<TransformDecorator.Transform> 
<TransformCollection> 

<ScaleTransform ScaleX="1" ScaleY="0.5" /> 
<TranslateTransform X="100" Y="0" /> 
</TransformCollection> 
</TransformDecorator.Transform> 
<Polygon ID="star2" 
Stroke="blue" 
StrokeThickness="2.0" 



IsAnimating 

IsChangeable 

I sO ve rrid i n g Base Va I ue 
ScaleX 

ScaleXAnimations 
ScaleY 

ScaleYAnimations 

StatusOfNextUse 

UlContext 
Value 
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Points="1 76.5,50 189.2,155.003 286.485,113.5 201.9,177 286.485,240.5 
189.2,198.997 176.5,304 163.8,198.997 66.5148,240.5 151.1,177 66.5148,113.5 
163.8,155.003" /> 
</TransformDecorator> 

<!-- Scaled in X --> 

<TransformDecorator AffectsLayout="false"> 
<TransformDecorator.Transform> 
<TransformCollection> 

<ScaleTransform ScaleX= ,, 0.5 ,, ScaleY= ,, r , /> 
<TranslateTransform X= ,, 0 ,, Y="100" /> 
</TransformCollection> 
</TransformDecorator.Transform> 
<Polygon ID="star3" 
Stroke="red" 
StrokeThickness="2.0" 

Points="1 76.5,50 189.2,155.003 286.485,113.5 201.9,177 286.485,240.5 
189.2,198.997 176.5,304 163.8,198.997 66.5148,240.5 151.1,177 66.5148,113.5 
163.8,155.003" /> 
</TransformDecorator> 

</Canvas> 

This example specifies scale transformations on several shapes. To transform an element, use a 
TransformDecorator and set its Transform to the transformation you wish to apply. Set the element to 
transform as the TransformDecorator object's Child, and add the TransformDecorator to a panel. The 
ScaleTransform class, one of the transformations you can use with a TransformDecorator, enables you to 
reposition and apply rendering changes elements like Rectangle, Polygon, and Button. 
The ScaleX and ScaleY properties resize an element according to the factor you specify. For example, 
setting ScaleX to 1 .5 resizes the element's x-axis value at 1 50 percent. 

The following example demonstrates a polygon scaled in several ways. The first polygon (black) reflects 
no transformation. 

//#C 

// Create a canvas to contain the shapes. 
Canvas myCanvas = new Canvas(); 

// Create a PointCollection to contain the points of the 
// Polygon shapes. 

PointCollection myPointCollection = new PointCollectionQ; 
myPointCollection.Add(new Point( 176.5, 50)); 
myPointCollection. Add(new Point(189, 155)); 
myPointCollection. Add(new Point(286, 113)); 
myPointCollection.Add(new Point(201, 177)); 
myPointCollection.Add(new Point(286, 240)); 
myPointCollection. Add(new Point(189, 198)); 
myPointCollection.Add(new Point(176, 304)); 
myPointCollection. Add(new Point(163, 198)); 
myPointCollection.Add(new Point(66, 240)); 
myPointCollection. Add(new Point(151, 177)); 
myPointCollection. Add(new Point(66, 113)); 
myPointCollection. Add(new Point(163, 155)); 

// Create the first Polygon. 

Polygon firstPolygon = new Polygon(); 

firstPolygon. Points = myPointCollection; 
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firstPolygon.Stroke = Brushes. Black; 
firstPoIygon.StrokeThickness = new Length(2); 
myCanvas.Children.Add(firstPolygon); 



'VB.NET 

' Create a PointCollection to contain the points of the 
1 Polygon shapes. 

Dim myPointCollection As new MSAvalon.Windows.Media.PointCollection 
myPointCollection.Add(new MSAvalon.Windows.Point(176.5, 50)) 
myPointCollection.Add(new MSAvalon.Windows.Point(189, 155)) 
myPointCollection. Add(new MSAvalon. Windows. Point(286, 113)) 
my PointCollection. Add(new MSAvalon. Windows. Point(201, 177)) 
myPointCollection.Add(new MSAvalon. Windows. Point(286, 240)) 
myPointCollection.Add(new MSAvalon.Windows.Point(189, 198)) 
myPointCollection.Add(new MSAvalon.Windows.Point(176, 304)) 
myPointCollection.Add(new MSAvalon.Windows.Point(163, 198)) 
myPointCollection.Add(new MSAvalon.Windows.Point(66, 240)) 
myPointCollection.Add(new MSAvalon.Windows.Point(151, 177)) 
myPointCollection.Add(new MSAvalon.Windows.Point(66, 113)) 
myPointCollection. Add(new MSAvalon.Windows.Point(163, 155)) 

' Create the first Polygon. 

Dim firstPolygon As new MSAvalon.Windows.Shapes.Polygon 

firstPolygon. Points = myPointCollection 

firstPolygon.Stroke = MSAvalon.Windows.Media.Brushes.Black 

firstPoIygon.StrokeThickness = new MSAvalon. Windows. Length(2) 

myCanvas.Children.Add(firstPolygon) 



The second polygon (blue) is scaled at 50 percent in y and translated by 150 pixels. Because there are 
multiple transformations, a TransformCollection object is used to contain the transformations and set the 
value of the TransformDecorator. Note that the scale transformation affects the element's stroke 
thickness as well as its size. In order to for the TranslateTransform to render, the AffectsLayout property 
of the TransformDecorator must be set to false. 

II CM 

II Create the second Polygon. This polygon contains the same 
// points as the first, but is scaled and translated. 
Polygon secondPolygon = new Polygon(); 
secondPolygon. Points = myPointCollection; 
secondPolygon.Stroke = Brushes.Blue; 
secondPolygon.StrokeThickness = new Length(2); 

// Add a semi-transparent gradient fill to make the shape stand out. 
RadialGradientBrush myGradient = 
new RadialGradientBrush(Colors.Blue, Colors. LimeGreen); 
myGradientOpacity = 0.4; 
secondPolygon. Fill = myGradient; 

// Create a TransformDecorator to transform secondPolygon. 
TransformDecorator transformer = new TransformDecorator(); 
transformer. AffectsLayout = false; 

// Create the scale and translate transformations. 
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ScaleTransform myScaleTransform = new ScaleTransform(1, 0.5); 
TranslateTransform myTranslateTransform = new TranslateTransform(150, 0); 

//Create a collection to contain the transformations. 
TransformCollection transformations = new TransformCollection(); 

transformations.Add(myScaleTransform); 
transformations.Add(myTranslateTransform); 
transformer. Transform = transformations; 

// Add secondPolygon as a child of the Transform Decorator. 
transformer.Child = secondPolygon; 

// Add the decorator to the Canvas. 
myCanvas.Children.Add(transformer); 



'VB.NET 

' Create the second Polygon. This polygon contains the same 

' points as the first, but is scaled and translated. 

Dim secondPolygon As new MSAvalon.Windows.Shapes.Polygon 

secondPolygon. Points = myPointCollection 

secondPolygon.Stroke = MSAvalon.Windows.Media.Brushes.Blue 

secondPolygon.StrokeThickness = new MSAvalon.Windows.Length(2) 

' Add a semi-transparent gradient fill to make the shape stand out. 
Dim myGradient As new MSAvalon.Windows.Media.RadialGradientBrush( _ 
Colors.Blue, Colors. LimeGreen) 
myGradient. Opacity = 0.4 
secondPolygon. Fill = myGradient 

' Create a TransformDecorator to transform secondPolygon. 

Dim transformer As new MSAvalon.Windows.Controls.TransformDecorator 

transformer.AffectsLayout = false 

1 Create the scale and translate transformations. 

Dim myScaleTransform As new MSAvalon.Windows.Media.ScaleTransform(1, 0.5) 

Dim myTranslateTransform As new MSAvalon.Windows.Media.TranslateTransform(150, 0) 

' Create a collection to contain the transformations. 

Dim transformations As new MSAvalon.Windows.Media.TransformCollection() 

transformations.Add(myScaleTransform) 
transformations.Add(myTranslateTransform) 
transformer.Transform = transformations 

' Add secondPolygon as a child of the TransformDecorator. 
transformer.Child = secondPolygon 

' Add the decorator to the Canvas. 
myCanvas.Children.Add(transformer) 



This example uses classes from the MSAvalon.Windows, MSAvalon.Windows.Media, and 
MSAvalon.Windows. Controls namespaces. 
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This example specifies scale transforms with a center point other than (0,0). To scale an element, use a 
ScaleTransform to specify the transformation, and a TransformDecorator to apply the transformation. 
Instead of adding the element to the Canvas or other Panel, add the element as child of the 
TransformDecorator and add the TransformDecorator to the Panel. 

The following example shows the effect of scaling on Rectangle elements. The first rectangle is not 
scaled. The second rectangle is scaled vertically by 2 from a Center of (0,0), the default center. Although 
the second rectangle was originally 50 pixels from the top of the canvas (before the transformation), the 
rectangle looks as though it were moved down another 50 pixels after the transformation. The third 
rectangle is vertically scaled by 2 from a center of (0,50). Like the second rectangle, the third rectangle is 
vertically doubled and its distance from the top of the canvas is doubled as well, but specifying the scale 
center of (0,50) has the effect of moving the rectangle 50 pixels up, placing its top edge back in alignment 
with the first rectangle. 

//C# 

// Create a canvas to contain the shapes. 
Canvas myCanvas = new Canvas(); 

// Create and set the first shape, and add it to the Canvas. 
Rectangle firstRectangle = new Rectangle(); 
firstRectangle.RectangleTop = new Length(50); 
firstRectangle. RectangleLeft = new Length(50); 
firstRectangle.RectangleHeight = new Length(50); 
firstRectangle.RectangleWidth = new Length(50); 
firstRectangle. Fill = Brushes. Red; 
firstRectangle. Stroke = Brushes. Black; 
myCanvas.Children.Add(firstRectangle); 

// Create and set the second shape. 
Rectangle secondRectangle = new Rectangle(); 
secondRectangle.RectangleTop = new Length(50); 
secondRectangle. RectangleLeft = new Length(150); 
secondRectangle.RectangleHeight = new Length(50); 
secondRectangle.RectangleWidth = new Length(50); 
secondRectangle. Fill = Brushes. Yellow; 
secondRectangle.Stroke = Brushes. Black; 

// Create a TransformDecorator to apply the transformation to the shape. 
TransformDecorator transformation = new TransformDecorator(); 
transformation.AffectsLayout = false; 

// Create a scale transform which doubles the length of the shape. 
// No scale is set, so it defaults to (0,0). 
ScaleTransform myScaleTransform = new ScaleTransform(); 
myScaleTransform.ScaleY = 2.0; 

// Assign the ScaleTransform to the TransformDecorator 
transformation.Transform = myScaleTransform; 

// Make the shape the child of the TransformDecorator and add the 
// TransformDecorator (which now contains the shape) to the Canvas, 
transformation. Child = secondRectangle; 
myCanvas. Children. Add(transformation); 

// Create and set the third shape. 

Rectangle thirdRectangle = new Rectangle(); 
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thirdRectangte.RectangleTop = new Length(50); 
thirdRectangle.RectangleLeft = new Length(250); 
thirdRectangle.RectangleHeight = new Length(50); 
thirdRectangle.RectangleWidth = new Length(50); 
thirdRectangle.Fill = Brushes. Blue; 
thirdRectangle.Stroke = Brushes.Black; 

// Create a new scale transform. This time the 
// transform's center is set to (0,50). 
myScaleTransform = new ScaleTransform(); 
myScaleTransform.Center = new Point(0 ( 50); 
myScaleTransform. ScaleY = 2.0; 

// Create another TransformDecorator to contain the third shape. 

// Assign the shape and the transformation to the TransformDecorator, 

// and add the TransformDecorator to the Canvas. 

TransformDecorator secondTransformation = new TransformDecorator(); 

secondTransformation.AffectsLayout = false; 

secondTransformation.Transform = myScaleTransform; 

secondTransformation.Child = thirdRectangle; 

myCanvas.Children.Add(secondTransformation); 



'VB.NET 

' Create and set the first shape, and add it to the Canvas. 
Dim firstRectangle As MSAvalon.Windows.Shapes.Rectangle 
firstRectangle = new MSAvalon.Windows.Shapes.Rectangle 
firstRectangle.RectangleTop = new MSA valon. Windows. Length(50) 
firstRectangle. RectangleLeft = new MSAvalon.Windows.Length(50) 
firstRectangle. RectangleHeight = new MSAvalon. Windows. Length(50) 
firstRectangle.RectangleWidth = new MSAvalon. Windows. Length(50) 
firstRectangle. Fill = MSAvalon.Windows. Media. Brushes. Red 
firstRectangle.Stroke = MSAvalon.Windows. Media.Brushes.Black 
myCanvas.Children.Add(firstRectangle) 

' Create and set the second shape. 

Dim secondRectangle As MSAvalon. Windows.Shapes. Rectangle 
secondRectangle = new MSAvalon. Windows.Shapes. Rectangle 
secondRectangle.RectangleTop = new MSAvalon.Windows. Length(50) 
secondRectangle. RectangleLeft = new MSAvalon. Windows.Length(1 50) 
secondRectangle.RectangleHeight = new MSAvalon.Windows. Length(50) 
secondRectangle. RectangleWidth = new MSAvalon.Windows. Length(50) 
secondRectangle. Fill = MSAvalon.Windows. Media. Brushes. Yellow 
secondRectangle.Stroke = MSAvalon.Windows. Media. Brushes. Black 

' Create a TransformDecorator to apply the transformation to the shape. 

Dim transformation As new MSAvalon.Windows.Controls.TransformDecorator 

transformation.AffectsLayout = false 

' Create a scale transform which doubles the length of the shape. 
' No scale is set, so it defaults to (0,0). 

Dim myScaleTransform As new MSAvalon.Windows.Media.ScaleTransform 
myScaleTransform. ScaleY = 2.0 

' Assign the ScaleTransform to the TransformDecorator 
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transformation.Transform = myScaleTransform 

' Make the shape the child of the TransformDecorator and add the 
' TransformDecorator (which now contains the shape) to the Canvas, 
transformation. Child = secondRectangle 
myCanvas.Children.Add(transformation) 

' Create and set the third shape. 

Dim thirdRectangle As new MSAvalon.Windows.Shapes.Rectangle 
thirdRectangle.RectangleTop = new MSAvalon.Windows.Length(50) 
thirdRectangle. RectangleLeft = new MSAvalon.Windows.Length(250) 
thirdRectangle. RectangleHeight = new MSAvalon. Windows. Length(50) 
thirdRectangle. RectangleWidth = new MSAvalon.Windows.Length(50) 
thirdRectangle. Fill = MSAvalon. Windows. Media. Brushes. Blue 
thirdRectangle.Stroke = MSAvalon. Windows. Media. Brushes. Black 

' Create a new scale transform. This time the 
' transform's center is set to (0,50). 

myScaleTransform = new MSAvalon.Windows.Media.ScaleTransform 
myScaleTransform.Center = new MSAvalon.Windows.Point(0, 50) 
myScaleTransform. Scale Y = 2.0 

' Create another TransformDecorator to contain the third shape. 

' Assign the shape and the transformation to the TransformDecorator, 

' and add the TransformDecorator to the Canvas. 

Dim secondTransformation As new MSAvalon.Windows.Controls.TransformDecorator 
secondTransformation. Transform = myScaleTransform 
secondTransformation. Child = thirdRectangle 
myCanvas.Children.Add(secondTransformation) 



When you transform an element, it is the coordinate space containing the element that is actually 
transformed, not just the element itself. Because the TransformDecorator performs the transformation in 
its parent's coordinate space— the Canvas— the element will be moved. If you specify a y-axis scale of 
2.0, not only is the element doubled, its distance from the top of the Canvas is doubled as well. There are 
several ways of moving the element back to its original position. You can move the element using a 
TranslateTransform, or you can specify the Center of the ScaleTransform, the more concise way of 
positioning the transformed element. The previous example moves the third rectangle by specifying the 
scale center. 

This example uses classes from the MSAvalon. Windows, MSAvalon.Windows.Controls, 
MSAvalon. Windows. Media, and the MSAvalon. Windows.Shapes namespaces. 

This example demonstrates how to animate the size of an element using "Longhorn" markup language 
(code-named "XAML"). There are multiple ways to animate the size of an element: directly animate the 
height and width attributes of the element, or apply an animated ScaleTransform to the element. In this 
example, two Rectangle elements are resized using these methods. One rectangle is resized by 
animating its RectangleWidth attribute and another is resized by animating a ScaleTransform applied to 
the rectangle. Each rectangle is filled with a pattern to highlight the differences between the two resizing 
methods. Initially, the two patterns look the same, but as the rectangles are resized, patterns change 
depending on how their containing rectangle is resized. 

In the first example, a Rectangle element's RectangleWidth property is animated using a 
LengthAnimationCollection and a LengthAnimation. The LengthAnimation object in this example animates 
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the rectangle's RectangleWidth from its base value of 200 To a destination value of 600 over a Duration 
of 10 seconds. 

<Canvas ID="root" 

xmlns= ,, http://schemas.microsoft.com/2003/xaml"> 

<Rectangle 
RectangleTop="20" 
RectangleLeft="20" 
RectangleWidth="200" 
RectangleHeight= M 150" 
Stroke="Red" 
StrokeThickness= n 5"> 

<Rectangle.Fill> 

<lmageBrush ViewPort="0,0 100,100" ViewPortUnits="Absolute" 
lmageSource="help.gif TileMode="Tile7> 
</Rectangle.Fill> 

<Rectangle.RectangleWidth> 
<!-- Animate the Rectangle's width: --> 
<LengthAnimationCollection> 
<LengthAnimation 

To="600" Durational 0" AutoReverse= M true" RepeatCount="50" /> 
</LengthAnimationCollection> 
</Rectangle.RectangleWidth> 

</Rectangle> 



When the previous "XAML" is run, more of the pattern is exposed as the rectangle expands; however, the 
question marks that make up the pattern do not grow larger. 

In the next example, a TransformDecorator is used to apply a ScaleTransform to a rectangle. A 
DoubleAnimation is used to animate the ScaleTransform object's ScaleX value using the 
ScaleXAnimations attribute. The DoubleAnimation animates the ScaleX value From 1 To a destination 
value of 3 over a Duration of 10 seconds. As a result, the rectangle's width is scaled from 100 percent (its 
starting size) to 300 percent over ten seconds. 
<Transform Decorator AffectsLayout="False"> 
<TransformDecorator.Transform> 

<!-- Use the ScaleTransform to enlarge the rectangle -> 
<ScaleTransform ScaleX= M 1" ScaleY="1"> 
<ScaleTransform.ScaleXAnimations> 
<DoubleAnimation From="1" To="3" RepeatCount="30" 
AutoReverse="True" Begin="0" Durational 0" /> 
</ScaleTransform.ScaleXAnimations> 
</ScaleTransform> 

</TransformDecorator.Transform> 

<Rectangle 
RectangleLeft="20" 
RectangleTop="200" 
RectangleWidth="200" 
RectangleHeight="150" 



259 



Stroke="Black M 
StrokeThickness= M 3"> 
<Rectangle.Fill> 

<lmageBrush ViewPort="0,0 100,100" ViewPortUnits="Absolute" 

lmageSource="help.gif TileMode="Tile'V> 
</Rectangle.Fill> 
</Rectangle> 
</TransformDecorator> 

</Canvas> 

In the previous example, the DoubleAnimationCollection tag, <DoubleAnimationCollection> is omitted 
when animating the transformation's scale factor. When animating a designated animation property- 
properties of the form PropertyNameAnimations, such as the ScaleXAnimations property in the previous 
example — you may omit the animation collection tag. However, when animating a property of a Ul 
element— those classes that derive from UlElement— you must nest the animations within an animation 
collection tag. 

When the second rectangle expands, the objects in the pattern also grow larger, unlike in the first 
rectangle. The pattern behaves this way because when you transform an element the entire element and 
its child elements are transformed. When you directly alter the size of an element, as in the case of the 
first rectangle, the element's children are not resized, unless their size and position are dependent on the 
size of their parent element. 

For more information about animating properties, see Animation in "Avalon". 

This example shows how to apply a ScaleTransform when an event occurs. The concept is the same for 
applying other types of transformations. See the Transform class for more information about the available 
types of transformations. 

To apply a specific transformation to an element, you must create a TransformDecorator that you will add 
to that element In markup, wrap the element with the TransformDecorator. When the event occurs, set 
the TransformProperty property of the TransformDecorator to the appropriate transformation, in this case 
a ScaleTransform. 

<Canvas ID="root" 
xmlns="http://schemas. microsoft.com/2003/xaml/" 
xmlns:def="Definition n > 

<TransformDecorator ID="tdr Affectsl_ayout="false"> 

<Button ID="Button1" MouseEnter="Enter" MouseLeave="Leave ,, >Button</Button> 
</Tra n sform Decora tor> 

<def:Code> 

<![CDATA[ 

Private Sub Enter(ByVal sender as object, ByVal args as MSAvalon.Windows.lnput.MouseEventArgs) 

Dim scaler As new ScaleTransform(2,2) 

tdl Transform = scaler 
End Sub 

Private Sub Leave(ByVal sender as object, ByVal e as MSAvalon.Windows.lnput.MouseEventArgs) 

Dim scaler As new ScaleTransform(1 ,1 ) 

tdl Transform = scaler 
End Sub 

]]> 
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</def:Code> 



</Canvas> 



SkewTransform Class 

Definition: Represents a two-dimensional skew. 



Method 

CloneCore 
CloneCore 

CloneDownToUnchangeable 
Copy 

Copy 

Copy 

CreateMatrix 

CreateRotation 

CreateScale 

CreateSkew 

CreateTranslation 

DisableCore 

Dispose 

EmbeddedAnimationCollectionReader 

EmbeddedAnimationColiectionWriter 

EmbeddedChangeableReader 

EmbeddedChangeableWriter 

EnableCore 

Equals 

Finalize 

GetCurrentValue 

GetCurrentValue 
GetCurrentValue 



Description 

Returns a modifiable shallow or deep clone of the current object. 
This abstract method must be implemented by classes that 
derive from Changeable. Inherited from Changeable. 
Implementation of Animatable.CloneCore. 

Returns an immutable copy of the specified object. Inherited 
from Changeable. 

Creates a copy of this Transform. Inherited from Transform. 

Returns a modifiable copy of the current object. The copy's 
IsChangeable property is true and its StatusOfNextUse is 
Unchangeable. Inherited from Changeable. 

Creates a copy of this SkewTransform. 

Creates an arbitrary affine transformation matrix used for 
transformations in a two-dimensional plane. Inherited from 
Transform. 

Creates a transformation used for rotation in a two-dimensional 
plane. Inherited from Transform. 

Creates a transformation used for scaling in a two-dimensional 
plane. Inherited from Transform. 

Creates a transformation used for skewing in a two-dimensional 
plane. Inherited from Transform. 

Creates a transformation used for translating in the x- and y- 
directions in a two-dimensional plane. Inherited from Transform. 
Inherited from Transform. 

Dispose resources associated with transform. Inherited from 
Transform. 

Maybe this should be internal?? Inherited from Animatable. 
Inherited from Animatable. 
Inherited from Animatable. 
Inherited from Animatable. 
Inherited from Transform. 

Determines whether two Object instances are equal. Inherited 
from Object. 

Inherited from Transform. 

Creates a non-animated copy of this Transform with all of its 
base values set to the current animated values. Inherited from 
Transform. 

Returns a non-animated version of this SkewTransform that 
represents its current state. 

Returns a non-animated version of this Animatable that 
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GetHasAnimations 

GetHashCode 

GetlsAnimating 

GetlsOverridingBaseValue 

GetType 

MakeUnchangeable 

MakeUnchangeableCore 
MemberwiseClone 

ModifyHandlerlfChangeable 
OnChanged 

PropagateEventHandler 
ReadPreamble 

ReferenceEquals 

SetDefaultParentTimeline 

SetDefaultParentTimeline 

SetDefaultParentTimelineCore 

SkewTransform 

ToString 

ValidateObjectState 
WritePostscript 



WritePreamble 



represents its current state. Inherited from Animatable. j 
Inherited from Transform. 

Serves as a hash function for a particular type, suitable for use in j 
hashing algorithms and data structures like a hash 
table. Inherited from Object. 

Inherited from Transform. 

Inherited from Transform. 

Gets the Type of the current instance. Inherited from Object. 

Makes an object immutable; after this method is called on a 
Changeable, its IsChangeable property is false. Inherited from 
Changeable. 

Implementation of MakeUnchangeableCore. Inherited from 
Transform. 

Creates a shallow copy of the current Object. Inherited from 
Object. 

Adds or removes a Changed event handler to or from the 
specified Changeable object, if the object is currently modifiable. 
If the specified object is not modifiable— if its IsChangeable 
property is false— this method has no effect. Inherited from 
Changeable. 

Called when the current object is modified. Classes that derive 
from Changed should call this method after they have been 
modified. Inherited from Changeable. 

Ensures that simple (non-Changeable) members are being 
accessed from a valid Ul context. This method should be called 
before any simple members are accessed. Inherited from 
Changeable. 

Determines whether the specified Object instances are the same 
instance. Inherited from Object. 

This will change the time parent for animations on any of the 
properties of this Changeable which are inheriting their time 
parent. Inherited from Animatable. 

Inherited from Transform. 

Inherited from Transform. 

Not implemented. Use Object.ToString instead. Inherited from 
Transform. 

Verifies that the current object has a valid state. If the object is in 
an invalid state, this method throws an exception. Inherited from 
Changeable. 

Causes the current object to validate itself and then invokes the 
OnChanged method. Inherited from Changeable. 
Ensures that simple (non-Changeable) members are being 
accessed from a valid user interface (Ul) context. This method 
should be called before any simple members are set. Inherited 
from Changeable. 
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Property Descripti n 

Used in conjunction with the ChangeableUsageOverride type sent in 

AllowChangeableReferenceOverride as a P arameterto ChangeableHelper.UseChangeable, to help 

determine when a Changeable being put into "use" should be 
promoted to "ChangeableReference". Inherited from Changeable. 

AngleX Gets or sets the x-axis skew angle, measured in degrees 

counterclockwise from the y-axis. 

Gets or sets a collection of DoubleModifier objects that animate the 
transformation's AngleX. 

Gets or sets the y-axis skew angle, measured in degrees 
counterclockwise from the x-axis. 



AngleXAnimations 
AngleY 



AngleYAnimations 

CanMakeUnchangeable 
Center 

CenterAnimations 
DefaultParentTimeline 

HasAnimations 

Identity 
IsAnimating 

IsChangeable 

IsOverridingBaseValue 

StatusOfNextUse 

UlContext 
Value 



Gets or sets a collection of DoubleModifier objects that animate the 
transformation's AngleY. 

True if this Changeable can be made unchangeable. Inherited from 
Changeable. 

Gets or sets the center point of the skew. 

Gets or sets a collection of PointModifier objects that animate the 
transformation's Center position. 

The current parent Timeline associated with this Animatable. This 
will be the Timeline set to the ParentTimeline property of this 
Animatable if one has been set and if not, the Timeline last passed 
into the SetDefaultParentTimeline method. Inherited from 
Animatable. 

Gets a Boolean that indicates whether the transformation has 
animations. 

Identity transformation. Inherited from Transform. 

Returns true if the transformation contains active animations. 

Gets a Boolean that indicates whether the object is currently 
modifiable. Inherited from Changeable. 

Gets or sets a UseStatus enumeration that specifies how the 
Changeable object behaves when it is "used." A Changeable object 
is considered used in the following situations: the object is set into a 
Property System property, the object is used as a sub-object in a 
complex Changeable object, or the object is used in a 
DrawingContext command. Inherited from Changeable. 

Gets the UlContext of the current object. The UlContext is used for 
maintaining thread safety. Inherited from Changeable. 
Gets the current skewing transformation value as a Matrix. 



SolidColorBrush Class 

Definition: Represents a solid, uniform fill. 

Method Description 

Returns a modifiable shallow or deep clone of the current object. 
CloneCore This abstract method must be implemented by classes that 

derive from Changeable. Inherited from Changeable. 
CloneCore Implementation of Animatable.CloneCore. 
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CloneDownToUnchangeable 
Copy 

Copy 

Copy 

DeserializeFrom 
DisableCore 

EmbeddedAnimationCollectionReader 
EmbeddedAnimationCollectionWriter 
EmbeddedChangeableReader 
EmbeddedChangeableWriter 
EnableCore 

Equals 

Finalize 

GetCurrentValue 



GetCurrentValue 

GetCurrentValue 
GetHasAnimations 

GetHashCode 

GetlsAnimating 

GetlsOverridingBaseValue 

GetType 

MakeUnchangeable 
MakeUnchangeableCore 

MemberwiseClone 



Returns an immutable copy of the specified object. Inherited 
from Changeable. 

Returns a modifiable copy of the brush. The copy's 
IsChangeable property is true and its StatusOfNextUse is 
Unchangeable. Inherited from Brush. 

Returns a modifiable copy of the current object. The copy's 
IsChangeable property is true and its StatusOfNextUse is 
Unchangeable. Inherited from Changeable. 

Returns a modifiable copy of the brush. The copy's 
IsChangeable property is true and its StatusOfNextUse is 
Unchangeable. 

Returns a new Brush initialized from the binary representation 
being read by the passed BinaryReader. Note that the 
BrushType byte has not been read when this method is called. 
Inherited from Brush. 

Maybe this should be internal?? Inherited from Animatable. 
Inherited from Animatable. 
Inherited from Animatable. 
Inherited from Animatable. 
Inherited from Brush. 

Determines whether two Object instances are equal. Inherited 
from Object. 

Inherited from Brush. 

Returns the current value of the brush. The returned brush has 
the same value as the current object, but doesn't vary over time; 
that is, the returned brush is a snapshot of the current object at 
the point in time at which this method was called. 
Returns the current value of the brush. The returned brush has 
the same value as the current object, but doesn't vary over time; 
that is, the returned brush is a snapshot of the current object at 
the point in time at which this method was called. Inherited from 
Brush. 

Returns a non-animated version of this Animatable that 
represents its current state. Inherited from Animatable. 
Inherited from Brush. 

Serves as a hash function for a particular type, suitable for use in 
hashing algorithms and data structures like a hash 
table. Inherited from Object. 

Inherited from Brush. 

Inherited from Brush. 

Gets the Type of the current instance. Inherited from Object. 
Makes an object immutable; after this method is called on a 
Changeable, its IsChangeable property is false. Inherited from 
Changeable. 

Implementation of MakeUnchangeableCore. Inherited from 
Brush. 

Creates a shallow copy of the current Object. Inherited from 
Object. 
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ModifyHandlerlfChangeable 
OnChanged 

PropagateEventHandler 
ReadPreamble 

ReferenceEquals 
SerializeOn 

SetDefaultParentTimeline 

SetDefaultParentTimeline 

SetDefaultParentTimelineCore 
SolidColorBrush 

ToString 

ValidateObjectState 
WritePostscript 

WritePreamble 



Adds or removes a Changed event handler to or from the 
specified Changeable object, if the object is currently modifiable. 
If the specified object is not modifiable— if its IsChangeable 
property is false— this method has no effect. Inherited from 
Changeable. 

Called when the current object is modified. Classes that derive 
from Changed should call this method after they have been 
modified. Inherited from Changeable. 

Ensures that simple (non-Changeable) members are being 
accessed from a valid Ul context. This method should be called 
before any simple members are accessed. Inherited from 
Changeable. 

Determines whether the specified Object instances are the same 
instance. Inherited from Object. 

Serialize this object using the passed writer 

Inherited from Brush. 

This will change the time parent for animations on any of the 
properties of this Changeable which are inheriting their time 
parent. Inherited from Animatable. 

Inherited from Brush. 

Initializes a new instance of the SolidColorBrush class. 

Returns a String that represents the current Object. Inherited 
from Object. 

Verifies that the current object has a valid state. If the object is in 
an invalid state, this method throws an exception. Inherited from 
Changeable. 

Causes the current object to validate itself and then invokes the 
OnChanged method. Inherited from Changeable. 
Ensures that simple (non-Changeable) members are being 
accessed from a valid user interface (Ul) context. This method 
should be called before any simple members are set. Inherited 
from Changeable. 



Property Description 

Used in conjunction with the ChangeableUsageOverride type sent in 

AllowChangeableReferenceOverride as a P arameter to ChangeableHelper.UseChangeable, to help 

determine when a Changeable being put into "use" should be 
promoted to "ChangeableReference". Inherited from Changeable. 

True if this Changeable can be made unchangeable. Inherited from 
Changeable. 

Gets or sets the color of the solid fill. 



CanMakeUnchangeable 



Color 
ColorAnimations 

DefaultParentTimeline 
HasAnimations 



Gets or sets a collection of ColorModifier objects that animate the 
brush's Color property. 

The current parent Timeline associated with this Animatable. This 
will be the Timeline set to the ParentTimeline property of this 
Animatable if one has been set and if not, the Timeline last passed 
into the SetDefaultParentTimeline method. Inherited from 
Animatable. 

Gets a Boolean that indicates whether the brush has animations. 
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IsAnimating 



Transform 



UlContext 



StatusOfNextUse 



Opacity 



OpacityAnimations 



IsChangeable 



IsOverridingBaseValue 



Gets a Boolean that indicates whether the object is currently 
modifiable. Inherited from Changeable. 

Gets a Boolean that indicates whether the SolidColorBrush is 
currently animated. 

Gets or sets the degree of opacity of a Brush. Inherited from Brush. 

Gets or sets the animations associated with the Opacity of the 
brush. Inherited from Brush. 

Gets or sets a UseStatus enumeration that specifies how the 
Changeable object behaves when it is "used." A Changeable object 
is considered used in the following situations: the object is set into a 
Property System property, the object is used as a sub-object in a 
complex Changeable object, or the object is used in a 
DrawingContext command. Inherited from Changeable. 

Gets or sets a transformation that is applied to the brush. This 
transformation is applied after all other mapping and positioning 
have been processed. Inherited from Brush. 

Gets the UlContext of the current object. The UlContext is used for 
maintaining thread safety. Inherited from Changeable. 



Use a SolidColorBrush to fill an area with a solid color. The Brushes class contains SolidColorBrush 
objects with predefined colors, such as Blue and Yellow. 

The SolidColorBrush class represents only solid-color fills; see Brush for a variety of other, more complex, 
ways you can fill an area, such as gradients (LinearGradientBrush, RadialGradientBrush) and images 
(ImageBrush, NineGridBrush). 

Color names are not case-sensitive. 

This example uses the SolidColorBrush class in "Longhorn" markup language (code-named "XAML") to 
color areas such as the window background and the border and interior of shapes. The SolidColorBrush 
creates fills that are uniform in color— it can't create gradient or pattern fills. SolidColorBrush uses both 
predefined color values and hexadecimal color values. In this example, several Ellipse shapes are 
created with identical fills and outlines, but the fills and outlines are specified in different formats to 
demonstrate the versatility of the SolidColorBrush class. 

In the following markup, a Canvas element is declared and its Background property is set to LightGray, 
one of the predefined colors. 

<Canvas ID="root" xmlns= , Mp://schemas.microsoft.com/2003/xamr 

Background="LightGray"> 
In the next example, the Fill and Stroke properties of an Ellipse are set using ARGB notation. ARGB 
consists of a pound sign (#) and eight digits. The pound sign indicates that the digits that follow are in 
hexidecimal (base-16) format. The first two digits specify the alpha value, or opacity, of the color. FF 
indicates a color that is fully opaque, while 00 indicates a color that is completely transparent. The next 
six digits of the number specify the red, green, and blue values of the color. 
The fill of the Ellipse is set to #FFFFFF00, which specifies a color that is fully opaque (FF), has the 
maximum amount of red (FF), the maximum amount of green (FF), and no blue(OO). This combination 
produces yellow. 

<Ellipse 
Fill="#FFFFFF00 M 
CenterX="100 M 
CenterY="200 H 
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RadiusX='75" 
RadiusY^TS" 
StrokeThickness="5" 
Stroke="#FF0000FF7> 

In the next example, the Fill and Stroke properties of an Ellipse are set using shorter hexidecimal 
notation. The alpha value is omitted, and one digit is used for each red, green, and blue value instead of 
two. The resulting Ellipse has colors identical to the first. 

<Ellipse 
Fill="#FF0 M 
CenterX="200" 
CenterY="200 H 
RadiusX="75" 
RadiusY="75 M 
StrokeThickness="5" 
Stroke="#00F7> 

In the next example, the Fill and Stroke properties of an Ellipse are set using two of the predefined colors, 
Yellow and Blue. The resulting Ellipse has colors identical to the previous two. 

<Ellipse 
Fill^'Yellow" 
CenterX="300" 
CenterY= ,, 200 M 
RadiusX="75" 
RadiusY="75" 
StrokeThickness="5" 
Stroke="Blue7> 

In the final example, the Fill property of a Polyline is set by explicitly declaring a SolidColorBrush. The 
Color property of the SolidColorBrush is set to Blue, and its Opacity property is set to 0.4, creating a fill 
that is blue and 40 percent opaque (or 60 percent translucent). 

<Polyline 

Points="300,200 400,125 400,275 300,200" 

Stroke="Purple" 

StrokeThickness= ,, 2.3"> 

<Polyline.Fill> 
<SolidColorBrush Color="Blue" Opacity= M 0.47> 
</Polyline.Fill> 

</Polyline> 

</Canvas> 

This example demonstrates several equivalent ways to specify color values to fill an area using code. The 
simplest syntax uses a named color property from the Brushes class. The Colors class provides the same 
named color properties which you can pass as an argument to SolidColorBrush. The example also shows 
how to pass Color values to SolidColorBrush as separate alpha, red, green, and blue values using the 
Color structure's static FromScRGB method. The example draws identical Ellipse shapes using identical 
colors specified in these different ways. 

II CM 

II Create the ellipses. 
Ellipse e1 = new Ellipse(); 
Ellipse e2 = new EllipseQ; 
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Ellipse e3 = new EllipseQ; 



// Set the fill value for the interior of each ellipse in 

// different ways that have identical results. 

el.Fill = Brushes.Blue; 

e2.Fill = new SolidColorBrush(Colors.Blue); 

e3.Fill = new SolidColorBrush(Color.FromScRGB(1, 0,0,1)); 

// Set the stroke value for the interior of each ellipse in 

// different ways that have identical results. 

el Stroke = Brushes.Black; 

e2. Stroke = new SolidColorBrush(Colors.Black); 

e3.Stroke = new SolidColorBrush(Color.FromScRGB(1 ,0,0,0)); 



This sample demonstrates only a few of the ways to instantiate Color objects. See Color for more 
information. 

In order to actually render the ellipse the example also sets values for the StrokeThickness, CenterX, 
CenterY, RadiusX, and RadiusY properties in order to set the size and position of each ellipse. 

II Ctt- 
ll Set the thickness of the stroke, 
el StrokeThickness = new Length(10); 
e2.StrokeThickness = new Length(10); 
e3.StrokeThickness = new Length(10); 

// Set the size and position of the ellipses. 
e1. CenterX = new Length(100); 
el CenterY = new Length(75); 
e1. RadiusX = new Length(50); 
el RadiusY = new Length(50); 

e2. CenterX = new Length(220); 
e2. CenterY = new Length(75); 
e2. RadiusX = new Length(50); 
e2. RadiusY = new Length(50); 

e3.CenterX = new Length(340); 
e3.CenterY = new Length(75); 
e3.RadiusX = new Length(50); 
e3. RadiusY = new Length(50); 



StartSegment Class 

Definition: StartSegment 



Method 



Description 



Copy 



CloneDownToUnchangeable 



CloneCore 



CloneCore 



Returns a modifiable shallow or deep clone of the current object. 
This abstract method must be implemented by classes that 
derive from Changeable. Inherited from Changeable. 

Implementation of Animatable.CloneCore. 

Returns an immutable copy of the specified object. Inherited 
from Changeable. 

Creates a copy of this PathSegment. Inherited from 
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PathSegment. 

Copy Creates a copy of this StartSegment. 

Returns a modifiable copy of the current object. The copy's 
Copy IsChangeable property is true and its StatusOfNextUse is 

Unchangeable. Inherited from Changeable. 
DisableCore Inherited from PathSegment. 

EmbeddedAnimationCollectionReader Maybe this should be internal?? Inherited from Animatable. 
EmbeddedAnimationCollectionWriter Inherited from Animatable. 



EmbeddedChangeableReader 

EmbeddedChangeableWriter 

EnableCore 

Equals 
Finalize 

GetCurrentValue 
GetCurrentValue 
GetCurrentValue 

GetHashCode 
GetType 

MakeUnchangeable 

MakeUnchangeableCore 
MemberwiseClone 

ModifyHandlerlfChangeable 
OnChanged 

PropagateEventHandler 
ReadPreamble 

ReferenceEquals 
SetDefaultParentTimeline 



Inherited from Animatable. 
Inherited from Animatable. 
Inherited from PathSegment. 

Determines whether two Object instances are equal. Inherited 
from Object 

Allows an Object to attempt to free resources and perform other 
cleanup operations before the Object is reclaimed by garbage 
collection. Inherited from Object. 

Returns a non-animated version of this GradientStop that 
represents its current state. Inherited from PathSegment. 

Returns a non-animated version of this Animatable that 
represents its current state. Inherited from Animatable. 

Returns a non-animated version of this BezierSegment that 
represents its current state. 

Serves as a hash function for a particular type, suitable for use in 
hashing algorithms and data structures like a hash 
table. Inherited from Object. 

Gets the Type of the current instance. Inherited from Object. 
Makes an object immutable; after this method is called on a 
Changeable, its IsChangeable property is false. Inherited from 
Changeable. 

Implementation of MakeUnchangeableCore. Inherited from 
PathSegment. 

Creates a shallow copy of the current Object. Inherited from 
Object. 

Adds or removes a Changed event handler to or from the 
specified Changeable object, if the object is currently modifiable. 
If the specified object is not modifiable — if its IsChangeable 
property is false — this method has no effect. Inherited from 
Changeable. 

Called when the current object is modified. Classes that derive 
from Changed should call this method after they have been 
modified. Inherited from Changeable. 

Implementation of PropagateEventHandler. 

Ensures that simple (non-Changeable) members are being 
accessed from a valid Ul context. This method should be called 
before any simple members are accessed. Inherited from 
Changeable. 

Determines whether the specified Object instances are the same 
instance. Inherited from Object. 

This will change the time parent for animations on any of the 
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SetDefaultParentTimelineCore 
StartSegment 

ToString 

ValidateObjectState 
WritePostscript 

WritePreamble 



properties of this Changeable which are inheriting their time 
parent Inherited from Animatable. 

Inherited from PathSegment. 

Returns a String that represents the current Object. Inherited 
from Object. 

Verifies that the current object has a valid state. If the object is in 
an invalid state, this method throws an exception. Inherited from 
Changeable. 

Causes the current object to validate itself and then invokes the 
OnChanged method. Inherited from Changeable. 

Ensures that simple (non-Changeable) members are being 
accessed from a valid user interface (Ul) context. This method 
should be called before any simple members are set. Inherited 
from Changeable. 



Property Description 

Used in conjunction with the ChangeableUsageOverride type sent in 

AllowChangeableReferenceOverride f * Parameter to ChangeableHelper.UseChangeable, to help 
* determine when a Changeable being put into use should be 

promoted to "ChangeableReference". Inherited from Changeable. 

True if this Changeable can be made unchangeable. Inherited from 
Changeable. 

The current parent Timeline associated with this Animatable. This 
will be the Timeline set to the ParentTimeline property of this 
Animatable if one has been set and if not, the Timeline last passed 
into the SetDefaultParentTimeline method. Inherited from 
Animatable. 



CanMakeUnchangeable 



DefaultParentTimeline 



HasAnimations 
IsAnimating 

IsChangeable 

IsOverridingBaseValue 

IsStroked 

Point 

PointAnimations 
StatusOfNextUse 

UlContext 



Gets a Boolean that indicates whether the segment has animations. 

Gets a Boolean that indicates whether the object is currently 
modifiable. Inherited from Changeable. 

Gets or sets a Boolean that determines whether the segment is 
stroked. Inherited from PathSegment. 



Gets or sets a UseStatus enumeration that specifies how the 
Changeable object behaves when it is "used." A Changeable object 
is considered used in the following situations: the object is set into a 
Property System property, the object is used as a sub-object in a 
complex Changeable object, or the object is used in a 
DrawingContext command. Inherited from Changeable. 

Gets the UlContext of the current object. The UlContext is used for 
maintaining thread safety. Inherited from Changeable. 
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SubLineCollecti n Class 

Definition: collection of subline. Subline can be object of one of these types GlyphRun LineOver Inline 
object 



Meth d 

CopyTo 
Equals 

Finalize 

GetEnumerator 

GetHashCode 

GetType 

MemberwiseClone 
ReferenceEquals 

ToString 



Description 

copies the elements of the collection to an Array, starting at a particular Array 
index 

Determines whether two Object instances are equal. Inherited from Object. 
Allows an Object to attempt to free resources and perform other cleanup 
operations before the Object is reclaimed by garbage collection. Inherited from 
Object. 

Get enumerator for subline collection 

Serves as a hash function for a particular type, suitable for use in hashing 
algorithms and data structures like a hash table. Inherited from Object. 
Gets the Type of the current instance. Inherited from Object. 
Creates a shallow copy of the current Object. Inherited from Object. 

Determines whether the specified Object instances are the same 
instance. Inherited from Object. 

Returns a String that represents the current Object. Inherited from Object. 



Property 

Count 

IsSynchronized 
SyncRoot 



Description 

Number of sublines in collection 

Telling the caller if the collection is internally synchronized and thread-safe 
Collection's synchronization object 



TileBrush Class 

Definition: Abstract class that describes a way to fill a region with one or more "tiles." Derived classes 
define the different types of tiles that can be used; for example, the ImageBrush enables you to fill an 
area with an image. 



Method 



CloneCore 
CloneCore 

CloneDownToUnchangeable 
Copy 

Copy 
Copy 

DeserializeFrom 
DisableCore 



Description 

Subclasses must implement this to provide clones of 
themselves. Inherited from Animatable. 

Returns a modifiable shallow or deep clone of the current object. 
This abstract method must be implemented by classes that 
derive from Changeable. Inherited from Changeable. 

Returns an immutable copy of the specified object. Inherited 
from Changeable. 

Creates a copy of this TileBrush. 

Returns a modifiable copy of the brush. The copy's 
IsChangeable property is true and its StatusOfNextUse is 
Unchangeable. Inherited from Brush. 

Returns a modifiable copy of the current object. The copy's 
IsChangeable property is true and its StatusOfNextUse is 
Unchangeable. Inherited from Changeable. 

Returns a new Brush initialized from the binary representation 
being read by the passed BinaryReader. Inherited from Brush. 
Inherited from Brush. 
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EmbeddedAnimationCollectionReader 
EmbeddedAnimationCollectionWriter 
EmbeddedChangeableReader 
EmbeddedChangeableWriter 
EnableCore 

Equals 

Finalize 



GetCurrentValue 



GetCurrentValue 

GetCurrentValue 
GetHasAnimations 

GetHashCode 

GetlsAnimating 

GetlsOverridingBaseValue 

GetType 

MakeUnchangeable 

MakeUnchangeableCore 
MemberwiseClone 



ModifyHandlerlfChangeable 
OnChanged 

PropagateEventHandler 
ReadPreamble 

ReferenceEquals 
SerializeOn 

SetDefaultParentTimeline 



Maybe this should be internal?? Inherited from Animatable. 
Inherited from Animatable. 
Inherited from Animatable. 
Inherited from Animatable. 
Inherited from Brush. 

Determines whether two Object instances are equal. Inherited 
from Object. 

Inherited from Brush. 

Returns the current value of the brush. The returned brush has 
the same value as the current object, but doesn't vary over time; 
that is, the returned brush is a snapshot of the current object at ' 
the point in time at which this method was called. Inherited from 
Brush. 

Returns a non-animated version of this TileBrush that 
represents its current state. 

Returns a non-animated version of this Animatable that 
represents its current state. Inherited from Animatable. 
Inherited from Brush. 

Serves as a hash function for a particular type, suitable for use 
in hashing algorithms and data structures like a hash 
table. Inherited from Object. 

Inherited from Brush. 

Inherited from Brush. 

Gets the Type of the current instance. Inherited from Object. 
Makes an object immutable; after this method is called on a 
Changeable, its IsChangeable property is false. Inherited from 
Changeable. 

Implementation of MakeUnchangeableCore. Inherited from 
Brush. 

Creates a shallow copy of the current Object. Inherited from 
Object. 

Adds or removes a Changed event handler to or from the 
specified Changeable object, if the object is currently modifiable. 
If the specified object is not modifiable— if its IsChangeable 
property is false— this method has no effect. Inherited from 
Changeable. 

Called when the current object is modified. Classes that derive 
from Changed should call this method after they have been 
modified. Inherited from Changeable. 
Inherited from Brush. 

Ensures that simple (non-Changeable) members are being 
accessed from a valid Ul context. This method should be called 
before any simple members are accessed. Inherited from 
Changeable. 

Determines whether the specified Object instances are the 
same instance. Inherited from Object. 

Serialize this object using the passed writer Inherited from 
Brush. 

Inherited from Brush. 
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SetDefaultParentTimeline 

SetDefaultParentTimelineCore 
TileBrush 

ToString 

ValidateObjectState 
WritePostscript 

WritePreamble 



This will change the time parent for animations on any of the 
properties of this Changeable which are inheriting their time 
parent. Inherited from Animatable. 
Inherited from Brush. 

Initalizes a new instance of the TileBrush class. 

Returns a String that represents the current Object. Inherited 
from Object. 

Verifies that the current object has a valid state. If the object is 
in an invalid state, this method throws an exception. Inherited 
from Changeable. 

Causes the current object to validate itself and then invokes the 
OnChanged method. Inherited from Changeable. 
Ensures that simple (non-Changeable) members are being 
accessed from a valid user interface (Ul) context. This method 
should be called before any simple members are set. Inherited 
from Changeable. 



Property 



AllowChangeableReferenceOverride 



CanMakeUnchangeable 



ContentUnits 



DefaultParentTimeline 

HasAnimations 

HorizontalAlignment 

IsAnimating 

IsChangeable 

IsOverridingBaseValue 
Opacity 

Opacity Animations 



StatusOfNextUse 



Stretch 



Description 

Used in conjunction with the ChangeableUsageOverride type sent in 
as a parameter to ChangeableHelper.UseChangeable, to help 
determine when a Changeable being put into "use" should be 
promoted to "ChangeableReference". Inherited from Changeable. 

True if this Changeable can be made unchangeable. Inherited from 
Changeable. 

Gets or sets a BrushMappingMode enumeration that specifies 
whether the value of the brush's ViewBox— the size and position of 
the brush's content— is relative to the size of the output area. This 
property only has an effect when the size of the brush's ViewPort is 
set to Reel Empty. 

The current parent Timeline associated with this Animatable. This will 
be the Timeline set to the ParentTimeline property of this Animatable 
if one has been set and if not, the Timeline last passed into the 
SetDefaultParentTimeline method. Inherited from Animatable. 
Gets a Boolean that indicates whether the brush has animations. 
Gets or sets a HorizontalAlignment enumeration that specifies how 
the brush's content is horizontally aligned within its tiles. 

Gets a Boolean that indicates whether the object is currently 
modifiable. Inherited from Changeable. 

Gets or sets the degree of opacity of a Brush. Inherited from Brush. 

Gets or sets the animations associated with the Opacity of the 
brush. Inherited from Brush. 

Gets or sets a UseStatus enumeration that specifies how the 
Changeable object behaves when it is "used." A Changeable object 
is considered used in the following situations: the object is set into a 
Property System property, the object is used as a sub-object in a 
complex Changeable object, or the object is used in a 
DrawingContext command. Inherited from Changeable. 
Gets or sets a Stretch enumeration that specifies how the brush's 
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TileMode 
Transform 

UlContext 

VerticalAlignment 
ViewBox 

ViewBoxAn imations 
ViewPort 

ViewPortAnimations 
ViewPortUnits 



selected content (ViewBox) is displayed in the brush's tiles 
(ViewPort). 

Gets or sets a TileMode structure that specifies how the brush's tiles 
fill the output area. 

Gets or sets a transformation that is applied to the brush. This 
transformation is applied after all other mapping and positioning have 
been processed. Inherited from Brush. 

Gets the UlContext of the current object. The UlContext is used for 
maintaining thread safety. Inherited from Changeable. 

Gets or sets a VerticalAlignment enumeration that specifies how the 
brush's content is vertically aligned within its tiles. 

Gets or sets the position and dimensions of the brush's content. 

Gets or sets a collection of RectModifier objects that animate the 
ViewBox of the brush. 

Gets or sets the position and dimensions of the brush's tiles. 

Gets or sets a collection of RectModifier objects that animate the 
ViewPort of the brush. 

Gets or sets a BrushMappingMode enumeration that specifies 
whether the value of the brush's ViewPort— the size and position of 
the brush's tiles— is relative to the size of the output area. 



Transform Class 

Definition: An abstract class that you use as the parent class of all types of transformations in a two- 
dimensional plane, including rotation (RotateTransform), scale (ScaleTransform), skew (SkewTransform), 
and translation (TranslateTransform). This class hierarchy differs from the Matrix structure both because it 
is a class and because it supports animation and enumeration semantics. 



Method 



CloneCore 



CloneCore 

CloneDownToUnchangeable 
Copy 

Copy 

CreateMatrix 

CreateRotation 

CreateScale 

CreateSkew 

CreateTranslation 



Description 

Returns a modifiable shallow or deep clone of the current object. 
This abstract method must be implemented by classes that derive 
from Changeable. Inherited from Changeable. 

Subclasses must implement this to provide clones of 
themselves. Inherited from Animatable. 

Returns an immutable copy of the specified object. Inherited from 
Changeable. 

Creates a copy of this Transform. 

Returns a modifiable copy of the current object. The copy's 
IsChangeable property is true and its StatusOfNextUse is 
Unchangeable. Inherited from Changeable. 

Creates an arbitrary affine transformation matrix used for 
transformations in a two-dimensional plane. 

Creates a transformation used for rotation in a two-dimensional 
plane. 

Creates a transformation used for scaling in a two-dimensional 
plane. 

Creates a transformation used for skewing in a two-dimensional 
plane. 

Creates a transformation used for translating in the x- and y- 
directions in a two-dimensional plane. 
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DisableCore 

Dispose Dispose resources associated with transform. 

EmbeddedAnimationCollectionReader Maybe this should be internal?? Inherited from Animatable. 
EmbeddedAnimationCollectionWriter Inherited from Animatable. 



EmbeddedChangeableReader 

EmbeddedChangeableWriter 

EnableCore 

Equals 

Finalize 

GetCurrentValue 

GetCurrentValue 
GetHasAnimations 

GetHashCode 

GetlsAnimating 

GetlsOverridingBaseValue 

GetType 

MakeUnchangeable 

MakeUnchangeableCore 
MemberwiseClone 



ModifyHandlerlfChangeable 

OnChanged 
PropagateEventHandler 

ReadPreamble 

ReferenceEquals 

SetDefaultParentTimeline 

SetDefaultParentTimeline 
SetDefaultParentTimelineCore 



Inherited from Animatable. 
Inherited from Animatable. 

Determines whether two Object instances are equal. Inherited 
from Object. 

Creates a non-animated copy of this Transform with all of its base 
values set to the current animated values. 

Returns a non-animated version of this Animatable that 
represents its current state. Inherited from Animatable. 

Serves as a hash function for a particular type, suitable for use in 
hashing algorithms and data structures like a hash 
table. Inherited from Object 



Gets the Type of the current instance. Inherited from Object 
Makes an object immutable; after this method is called on a 
Changeable, its IsChangeable property is false. Inherited from 
Changeable. 

Implementation of MakeUnchangeableCore. 

Creates a shallow copy of the current Object. Inherited from 
Object 

Adds or removes a Changed event handler to or from the 
specified Changeable object, if the object is currently modifiable. 
If the specified object is not modifiable — if its IsChangeable 
property is false— this method has no effect. Inherited from 
Changeable. 

Called when the current object is modified. Classes that derive 
from Changed should call this method after they have been 
modified. Inherited from Changeable. 

Shares a Changed event handler with the current object's data 
members or removes it. Inherited from Changeable. 

Ensures that simple (non-Changeable) members are being 
accessed from a valid Ul context. This method should be called 
before any simple members are accessed. Inherited from 
Changeable. 

Determines whether the specified Object instances are the same 
instance. Inherited from Object 

This will change the time parent for animations on any of the 
properties of this Changeable which are inheriting their time 
parent. Inherited from Animatable. 
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ToString 

ValidateObjectState 
WritePostscript 

WritePreamble 

Property 



Not implemented. Use Object.ToString instead. 

Verifies that the current object has a valid state. If the object is in 
an invalid state, this method throws an exception. Inherited from 
Changeable. 

Causes the current object to validate itself and then invokes the 
OnChanged method. Inherited from Changeable. 

Ensures that simple (non-Changeable) members are being 
accessed from a valid user interface (Ul) context. This method 
should be called before any simple members are set. Inherited 
from Changeable. 



Description 

Used in conjunction with the ChangeableUsageOverride type sent in 

AllowChangeableReferenceOverride » a P arame * er to ChangeableHelper.UseChangeable, to help 

determine when a Changeable being put into use should be 
promoted to "ChangeableReference". Inherited from Changeable. 

True if this Changeable can be made unchangeable. Inherited from 
Changeable. 

The current parent Timeline associated with this Animatable. This 
will be the Timeline set to the ParentTimeline property of this 
DefaultParentTimeline Animatable if one has been set and if not, the Timeline last passed 

into the SetDefaultParentTimeline method. Inherited from 
Animatable. 



CanMakeUnchangeable 



HasAnimations 
Identity 

IsAnimating 

IsChangeable 

IsOverridingBaseValue 



StatusOfNextUse 

UlContext 
Value 



Returns true if any of the properties on this Changeable have 
animations attached. Inherited from Animatable. 
Identity transformation. 

Returns true if any of the properties on this Changeable have 
animations attached that are currently animating their 
value. Inherited from Animatable. 

Gets a Boolean that indicates whether the object is currently 
modifiable. Inherited from Changeable. 

Returns true if any of the properties on this Changeable have 
animations attached that are currently affecting their value either by 
animating it or holding it in a fill state. Inherited from Animatable. 

Gets or sets a UseStatus enumeration that specifies how the 
Changeable object behaves when it is "used." A Changeable object 
is considered used in the following situations: the object is set into a 
Property System property, the object is used as a sub-object in a 
complex Changeable object, or the object is used in a 
DrawingContext command. Inherited from Changeable. 

Gets the UlContext of the current object. The UlContext is used for 
maintaining thread safety. Inherited from Changeable. 

Gets the current transformation as a Matrix object. 



Use the MatrixTransform class to create custom transformations not provided by the RotateTransform, 
ScaleTransform, SkewTransform, and TranslateTransform classes. 

A 3x3 matrix is used for transformations in a two-dimensional x-y plane. Affine transformation matrices 
can be multiplied to form any number of linear transformations, such as rotation and skew (shear), 
followed by translation. An affine transformation matrix has its final column equal to (0, 0, 1), so only the 
members in the first two columns need to be specified. 
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An "Avalon" Matrix has the following structure: 



M11 M12 0 
M21 M22 0 
OffsetX OffsetY 1 

The members in the last row, OffsetX and OffsetY, represent translation values. 

In methods and properties, the transformation matrix is usually specified as a vector with only six 

members, as follows: 

(M11, M12, M21, M22, OffsetX, OffsetY) 

This example specifies rotation transforms on several shapes. The Transform class enables you to 
reposition and apply rendering changes to shape elements such as Rectangle, Polyline, and Ellipse. 
The RotateTransform class specifies a rotation of the coordinate system. By default, the coordinate 
system is rotated about (0,0), the default origin, by r degrees. The following code provides some 
examples of different rotations, some in conjunction with translation. 

<Canvas ID="root" 

xmlns="http://schemas.microsoft.com/2003/xamr 
xmlns:def= ,, Definition ,, > 

<!- No transform --> 
<PolylinelD= ,, box1" 

Stroke= ,, Black M 

StrokeThickness= M 5" 

Points="0,0 10,10 10,50 50,50 50,10 10,10" /> 

<!- Rotate about a set origin, then translate --> 
<TransformDecorator AffectsLayout-'false'^ 
<TransformDecorator.Transform> 
<TransformCollection> 

<RotateTransform Angle="90" /> 
<TranslateTransform X="100" Y= M 100" /> 

<fT ransformCollection> 
</TransformDecorator.Transform> 
<Polyline ID="box2" 

Stroke= M Blue" 

StrokeTh ickness="5 M 

Points="0,0 10,10 10,50 50,50 50,10 10,10 M > 
</Polyline> 

</TransformDecorator> 

<TransformDecorator AffectsLayout="false M > 
<TransformDecoratorTransform> 
<TransformCollection> 

<RotateTransform Angle- '-45" /> 
<TranslateTransform X="100" Y="100 M /> 

</TransformCollection> 
</T ransformDecorator.Transform> 
<Polyline ID="box3 n 

Stroke="Orange M 

StrokeThickness= M 5 n 

Points= H 0,0 10,10 10,50 50,50 50,10 10,10"> 
</Polyline> 

</TransformDecorator> 



277 



<TransformDecorator AffectsLayout="false"> 
<TransformDecorator.Transform> 
<TransformCollection> 

<RotateTransform Angle="45" /> 
<TranslateTransform X= ,, 100" Y="100" /> 

</TransformCollection> 
</TransformDecorator.Transform> 
<Polyline ID-'box^' 

Stroke="Green" 

StrokeThickness="5" 

Points="0,0 10,10 10,50 50,50 50,10 10,10"> 
</Polyline> 

</TransformDecorator> 

<!-- Translate, then rotate --> 
<Transform Decorator AffectsLayout="false M > 
<Tra n sfo rm Decorator. Tra n sf o rm > 
<TransformCollection> 

<TranslateTransform X="200 H Y="200" /> 
<RotateTransform Angle="15" /> 

</TransformCollection> 
</TransformDecorator.Transform> 
<Polyline ID="box5 H 

Stroke="Cyan" 

StrokeThickness="5" 

Points="0,0 10,10 10,50 50,50 50,10 10,10"> 
</Polyline> 

</T ransformDecorator> 
</Canvas> 

When using rotation transformations, keep in mind that the transformation rotates the coordinate system 
for a particular element. This might apply effects that you should anticipate when working out the screen 
coordinates for elements. Depending on an element's position with respect to the origin, the effect of the 
rotation might not be to rotate it "in place." For an element positioned 200 units from 0 along the x-axis, 
for instance, a rotation of 30 degrees has the effect of swinging the element 30 degrees along a circle 
with radius 200, drawn around the origin. 

The Center attribute on the RotateTransform element allows you to set an origin about which the shape 
will be rotated. Note that in the preceding example, the start points of the blue, orange, and green 
Polyline elements are all located at (100,100) because the Center attribute of those elements is 
(100,100). The cyan Polyline, however, was rotated 15 degrees on an arc from (200,200) because its 
TranslateTransform was applied first. 

This example uses a RotateTransform object to rotate a Shape element. To scale an element, use a 
ScaleTransform object to specify the transformation, and a Transform Decorator object to apply the 
transformation. Instead of adding the element to the Canvas element or other Panel element, add the 
element as child of the TransformDecorator and add the TransformDecorator to the Panel. 
The RotateTransform object specifies a rotation of the coordinate system. By default, the coordinate 
system is rotated about (0,0), the default origin, by r degrees. The following code shows the two shapes. 
The first shape is not rotated. The second shape is rotated by 45 degrees around a RotateTransform of 
(1 10,1 10), the lower right corner of the shape. As a result, the shape appears as though it was rotated 
about its corner. 

//C# 

// Create a canvas to contain the shapes. 
Canvas myCanvas = new CanvasQ; 
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// Create a PointCollection to contain the points of the Polygon shapes. 
PointCollection myPointCollection = new PointCollection(); 
myPointCollection.Add(new Point(60, 60)); 
myPointCollection.Add(new Point(70, 70)); 
myPointCollection. Add(new Point(70, 110)); 
myPointCollection.Add(new Point(110, 110)); 
myPointCollection.Add(new Point(110, 70)); 
myPointCollection.Add(new Point(70 t 70)); 

// Create the first Polygon and add it to the Canvas. 
Polygon boxl = new Polygon(); 
boxl. Points = myPointCollection; 
boxl .Stroke = Brushes. Black; 
boxLStrokeThickness = new Length(5); 
myCanvas.Children.Add(box1 ); 

// Create the second Polygon. This polygon contains the same points as the 

// first, but is rotated. 

Polygon box2 = new Polygon(); 

box2. Points = myPointCollection; 

box2. Stroke = Brushes. Blue; 

box2.StrokeThickness = new Length(5); 

// Create a TransformDecorator to transform the shape. 
TransformDecorator transformer = new TransformDecorator(); 
transformer. AffectsLayout = false; 

// Create the rotation transformation. 

RotateTransform myRotateTransform = new RotateTransform(45, new Point(110,110)); 

// Set the TransformDecorator.Transform property. 
transformer.Transform = myRotateTransform; 

// Add box2 as a child of the TransformDecorator and add the TransformDecorator 
// to the Canvas. 
transformer.Child = box2; 
myCanvas.Children.Add(transformer); 



' VB .NET 

' Create a PointCollection to contain the points of the 
' Polygon shapes. 

Dim myPointCollection As MS Avalon. Windows. Media. PointCollection 
myPointCollection = new MSAvalon.Windows.Media.PointCollection 
my PointCollection. Add(new MSAvalon. Windows. Point(60, 60)) 
myPointCollection. Add(new MSAvalon. Windows. Point(70, 70)) 
myPointCollection.Add(new MSAvalon. Windows. Point(70, 110)) 
myPointCollection.Add(new MSAvalon. Windows. Point( 110, 110)) 
myPointCollection.Add(new MSAvalon. Windows. Point( 110, 70)) 
my PointCollection. Add(new MSAvalon. Windows. Point(70, 70)) 

1 Create the first Polygon and add it to the Canvas. 
Dim boxl As MSAvalon.Windows.Shapes.Polygon 
boxl = new MSAvalon.Windows.Shapes.Polygon 
boxl .Points = myPointCollection 
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box! Stroke = Brushes. Black 

boxl.StrokeThickness = new MSAvalon. Windows. Length(5) 
myCanvas.Children. Add(box1 ) 

' Create the second Polygon. This polygon contains the same 

' points as the first, but is rotated. 

Dim box2 As MSAvalon.Windows.Shapes.Polygon 

box2 = new MSAvalon.Windows.Shapes.Polygon 

box2. Points = myPointCollection 

box2.Stroke = Brushes.Blue 

box2.StrokeThickness = new MSA valon. Windows. Length(5) 

' Create a Transform Decorator to transform the shape. 
Dim transformer As MSAvalon.Windows.Controls.TransformDecorator 
transformer = new MSAvalon.Windows.Controls.TransformDecorator 
transformer.AffectsLayout = false 

' Create the scale transformation. 
Dim myRotateTransform As _ 

new MSAvalon. Windows. Media. RotateTransform(45, _ 
new MSAvalon.Windows.Point(110,110)) 

'Set the TransformDecoratorTransform property 
transformer.Transform = myRotateTransform 

'Add box2 as a child of the TransformDecorator and add 
'the TransformDecorator to the Canvas. 
transformer.Child = box2 
myCanvas.Children.Add(transformer) 

When using rotation transformations, keep in mind that the transformation rotates the coordinate system 
for a particular element. This might apply effects that you should anticipate when working out the screen 
coordinates for elements. Depending on an element's position with respect to the origin, the effect of the 
rotation might not be to rotate it "in place." For example, for an element positioned 200 units from 0 along 
the x-axis a rotation of 30 degrees has the effect of swinging the element 30 degrees along a circle with 
radius 200, drawn around the origin. 

Although the previous example shows how to rotate a Shape element, the process is the same for other 
elements, including Button and Panel elements. 

This example specifies scale transformations on several shapes. The ScaleTransform class enables you 
to reposition and apply rendering changes to shape elements like Rectangle, Polygon, and Ellipse. 
The ScaleX and ScaleY properties resize an element according to the factor you specify. For example, 
setting ScaleX to 1 .5 resizes the element's X-axis value at 1 50 percent. 

The following example demonstrates a polygon scaled in several ways. The first polygon (black) reflects 
no transformation. The second polygon (blue) is scaled at 50 percent in Y, and the third polygon (red) is 
scaled at 50 percent in X. Two of the polygons also include translation transformations for repositioning. 
Note that the scale transformation affects the element's stroke-thickness as well as its size. 

<Canvas ID="root" 

xmlns= M http://schemas.microsoft.com/2003/xamr'> 

<!- No transform specified -> 
<Polygon ID="star1" 
Stroke="black" 
StrokeThickness="2.0" 

Points="1 76.5,50 189.2,155.003 286.485,113.5 201.9,177 286.485,240.5 
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189.2,198.997 176.5,304 163.8,198.997 66.5148,240.5 151.1,177 66.5148,113 5 

163.8,155.003"> 

</Polygon> 

<!-- Scaled in Y ~> 

<TransformDecorator AffectsLayout= n false"> 
<TransformDecorator.Transform> 
<TransformCollection> 

<ScaleTransform ScaleX="1" ScaleY= H 0.5" /> 
<TranslateTransform X="100" Y="0" /> 
</TransformCollection> 
</TransformDecorator.Transform> 
<Polygon ID="star2" 
Stroke="blue" 
StrokeThickness="2.0" 

Points="1 76.5,50 189.2,155.003 286.485,113.5 201.9,177 286.485,240 5 
189.2,198.997 176.5,304 163.8,198.997 66.5148,240.5 151.1,177 66.5148,113 5 
163.8,155.003" /> 
</TransformDecorator> 

<!-- Scaled in X --> 

<TransformDecorator AffectsLayout="false"> 
<TransformDecorator.Transform> 
<TransformCollection> 

<ScaleTransform ScaleX="0.5" Scale Y="1" /> 
<TranslateTransform X="0 M Y="100" /> 
</TransformCollection> 
</TransformDecorator.Transform> 
<Polygon ID= M star3" 
Stroke="red" 
StrokeTh ickness="2 . 0" 

Points="1 76.5,50 189.2,155.003 286.485,1 13.5 201.9,177 286.485,240 5 
189.2,198.997 176.5,304 163.8,198.997 66.5148,240.5 151.1,177 66.5148 113 5 
163.8,155.003" /> 
</TransformDecorator> 

</Canvas> 

This example specifies scale transformations on several shapes. To transform an element, use a 
Transform Decorator and set its Transform to the transformation you wish to apply. Set the element to 
transform as the TransformDecorator object's Child, and add the Transform Decorator to a panel. The 
ScaleTransform class, one of the transformations you can use with a TransformDecorator, enables you to 
reposition and apply rendering changes elements like Rectangle, Polygon, and Button. 

The ScaleX and ScaleY properties resize an element according to the factor you specify. For example, 
setting ScaleX to 1 .5 resizes the element's x-axis value at 1 50 percent. 

The following example demonstrates a polygon scaled in several ways. The first polygon (black) reflects 
no transformation. 

//#C 

// Create a canvas to contain the shapes. 
Canvas myCanvas = new Canvas(); 

// Create a PointCollection to contain the points of the 
// Polygon shapes. 
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PointCollection myPointCollection = new PointCollection(); 
myPointCollection.Add(new Point(1 76.5, 50)); 
myPointCollection. Add(new Point(189, 155)); 
myPointCollection. Add(new Point(286, 113)); 
myPointCollection. Add(new Point(201, 177)); 
myPointCollection.Add(new Point(286, 240)); 
my PointCollection. Add(new Point(189, 198)); 
myPointCollection.Add(new Point(176, 304)); 
myPointCollection. Add(new Point(163, 198)); 
myPointCollection.Add(new Point(66, 240)); 
myPointCollection.Add(new Point(151, 177)); 
myPointCollection. Add(new Point(66, 113)); 
myPointCollection. Add(new Point(163, 155)); 

// Create the first Polygon. 

Polygon firstPolygon = new Polygon(); 

firstPolygon. Points = myPointCollection; 

firstPolygon. Stroke = Brushes. Black; 

firstPolygon.StrokeThickness = new Length(2); 

myCanvas.Children.Add(firstPolygon); 



•VB.NET 

' Create a PointCollection to contain the points of the 
' Polygon shapes. 

Dim myPointCollection As new MSAvalon.Windows.Media.PointCollection 
myPointCollection.Add(new MSAvalon.Windows.Point(176.5, 50)) 
myPointCollection.Add(new MSAvalon.Windows.Point(189, 155)) 
myPointCollection.Add(new MSAvalon. Windows. Point(286, 113)) 
myPointCollection.Add(new MSAvalon.Windows.Point(201, 177)) 
myPointCollection.Add(new MSAvalon. Windows. Point(286, 240)) 
myPointCollection.Add(new MSAvalon.Windows.Point(189, 198)) 
myPointCollection. Add(new MSAvalon.Windows.Point(176, 304)) 
my PointCollection. Add(new MSAvalon.Windows.Point(163, 198)) 
my PointCollection. Add(new MSAvalon. Windows. Point(66, 240)) 
myPointCollection. Add(new MSAvalon.Windows.Point(151, 177)) 
myPointCollection.Add(new MSAvalon. Windows. Point(66, 113)) 
myPointCollection.Add(new MSAvalon.Windows.PointOBS, 155)) 

' Create the first Polygon. 

Dim firstPolygon As new MSAvalon.Windows.Shapes. Polygon 

firstPolygon. Points = myPointCollection 

firstPolygon.Stroke = MSAvalon.Windows.Media.Brushes.Black 

firstPolygon.StrokeThickness = new MSAvalon.Windows.Length(2) 

myCanvas.Children.Add(firstPolygon) 

The second polygon (blue) is scaled at 50 percent in y and translated by 150 pixels. Because there are 
multiple transformations, a TransformCollection object is used to contain the transformations and set the 
value of the TransformDecorator. Note that the scale transformation affects the element's stroke 
thickness as well as its size. In order to for the TranslateTransform to render, the AffectsLayout property 
of the TransformDecorator must be set to false. 

II CH- 
ll Create the second Polygon. This polygon contains the same 
// points as the first, but is scaled and translated. 
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Polygon second Polygon = new Polygon(); 
secondPolygon.Points = myPointCollection; 
secondPolygon.Stroke = Brushes. Blue; 
secondPolygon.StrokeThickness = new Length(2); 

// Add a semi-transparent gradient fill to make the shape stand out. 
RadialGradientBrush myGradient = 
new RadialGradientBrush(Colors.Blue, Colors.LimeGreen); 
myGradient.Opacity = 0.4; 
secondPolygon.Fill = myGradient; 

// Create a TransformDecorator to transform secondPolygon. 
Transform Decorator transformer = new TransformDecorator(); 
transformer. AffectsLayout = false; 

// Create the scale and translate transformations. 
ScaleTransform myScaleTransform = new ScaleTransform(1, 0.5); 
TranslateTransform myTranslateTransform = new TranslateTransform(150, 0); 

//Create a collection to contain the transformations. 
TransformCollection transformations = new TransformCollection(); 

transformations.Add(myScaleTransform); 
transformations.Add(myTranslateTransform); 
transformer.Transform = transformations; 

// Add secondPolygon as a child of the TransformDecorator. 
transformer.Child = secondPolygon; 

// Add the decorator to the Canvas. 
myCanvas.Children.Add(transformer); 



'VB.NET 

' Create the second Polygon. This polygon contains the same 

' points as the first, but is scaled and translated. 

Dim secondPolygon As new MSAvalon.Windows.Shapes.Polygon 

secondPolygon.Points = myPointCollection 

secondPolygon.Stroke = MSAvalon.Windows.Media.Brushes.Blue 

secondPolygon.StrokeThickness = new MSAvalon. Windows. Length(2) 

' Add a semi-transparent gradient fill to make the shape stand out. 
Dim myGradient As new MSAvalon.Windows.Media.RadialGradientBrush( _ 
Colors. Blue, Colors.LimeGreen) 
myGradient.Opacity = 0.4 
secondPolygon.Fill = myGradient 

' Create a TransformDecorator to transform secondPolygon. 

Dim transformer As new MSAvalon.Windows.Controls.TransformDecorator 

transformer.AffectsLayout = false 

1 Create the scale and translate transformations. 

Dim myScaleTransform As new MSAvalon.Windows.Media.ScaleTransform(1, 0.5) 

Dim myTranslateTransform As new MSAvalon.Windows.Media.TranslateTransform(150, 0) 

' Create a collection to contain the transformations. 
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Dim transformations As new MSAvalon.Windows.MediaTransformCollection() 

transformations.Add(myScaleTransform) 
transformations.Add(myTranslateTransform) 
transformer. Transform = transformations 

1 Add secondPolygon as a child of the Transform Decorator. 
transformer.Child = secondPolygon 

' Add the decorator to the Canvas. 
myCanvas.Children.Add(transformer) 



This example uses classes from the MSAvalon. Windows, MSAvalon.Windows.Media, and 
MSAvalon. Windows. Controls namespaces. 

This example specifies translation transforms on several shapes. The Transform class enables you to 
reposition and apply rendering changes to shape elements like Rectangle, Polygon, and Ellipse. 

The translate value setting repositions the current coordinate system, locating the new origin of that 
coordinate system at the specified values. In the following example, two Polyline shapes indicate the 
original coordinate system and a translation to (50, 50). 

<Canvas ID="root" 

xmlns="http://schemas.microsoft.com/2003/xaml M > 

<!-- No translation -> 
<PolylinelD="angle1" 
Stroke="red n 
StrokeThickness= n 10" 
Points= M 10,160 10,10 160,10"> 
</Polyline> 

<!-- Translation in x- and y- axes. -> 
<TransformDecorator AffectsLayout="false M > 
<TransformDecoratorTransform> 
<TransformCollection > 

<TranslateTransform X="50" Y="50" /> 
</TransformCollection> 
</TransformDecoratorTransform> 

<Polyline ID="angle2" 
Stroke= M blue" 
StrokeThickness="10 M 
Points="10,160 10,10 160,10 M > 
</Polyline> 

</TransformDecorator> 

</Canvas> 

When using translations with other transformations, consider how the translation will affect the 
computation of those transformations. For example, consider a shape positioned at (100, 100). If the 
coordinate system is rotated by thirty degrees, the shape occupies a different screen position than if it 
had been positioned at (0, 0) when the rotation was computed. 
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<DockPanei ID="root" 

xmlns= u http://schemas.microsoft.com/2003/xamr , > 

<!- Shape with no transformation -> 
<Polyline ID="box1" 
Stroke="black" 
StrokeThickness="5 M 

Points="0,0 10,10 10,50 50,50 50,10 10,10" /> 

<!-- Translation only --> 
<TransformDecorator AffectsLayout= ,, false"> 
<TransformDecoratorTransform> 
<TransformCollection > 

<TranslateTransform X= H 100" Y="100" /> 
</TransformCollection> 
</TransformDecorator.Transform> 
<Polyline I D="box2" 
Stroke="red" 
StrokeThickness= M 5" 

Points="0,0 10,10 10,50 50,50 50,10 10,10"> 
</Polyline> 

</TransformDecorator> 

<!-- Rotate at origin, then translate --> 

<TransformDecorator AffectsLayout="false M > 
<TransformDecorator.Transform> 
<TransformCollection > 

<RotateTransform Center="0 0" Angle="-30" /> 
<TranslateTransform X= ,, 100 M Y="100 H /> 
</TransformCollection> 
</TransformDecorator.Transform> 
<Polyline ID="box3" 
Stroke= ,, blue" 
StrokeThickness="5" 

Points="0,0 10,10 10,50 50,50 50,10 10,1 0 H > 
</Polyline> 

</TransformDecorator> 

<!- Translate, then rotate the new coordinate system (note the different 
element position) -> 

<TransformDecorator AffectsLayout="false n > 
<TransformDecorator.Transform> 
<TransformCollection > 

<TranslateTransform X="100" Y="100" /> 
<RotateTransform Center= M 0 0" Angle^'-SO" /> 
</TransformCollection> 
</TransformDecorator.Transform> 
<Polyline ID="box4" 
Stroke =,, orange" 
StrokeThickness="5" 

Points="0,0 10,10 10,50 50,50 50,10 10,10"> 
</Polyline> 

<fT ransformDecorator> 
</DockPanel> 
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For many rotation, scale, and skew transformations, it can be helpful to translate a positioned element to 
the origin, apply the rotation, scale, or skew value, and then translate the element back to its intended 
screen position. This practice makes it less cumbersome to account for specific element positions across 
transformations because transformed elements reflect specific positioning values explicitly set in markup. 

This example demonstrates how to use the Transform property of brushes to apply transformations to 
LinearGradientBrush and RadialGradientBrush fills. A LinearGradientBrush is used to fill the first two 
Rectangle elements. The difference between the rectangles is that the LinearGradientBrush in the second 
rectangle is rotated 45 degrees. The second pair of rectangles illustrates the before and after effect of a 
ScaleTransform by reducing a RadialGradientBrush to half its normal height. 

<Border xmlns= M http://schemas.microsoft.com/2003/xaml" 
Background= M #CCCCCC"> 

<Canvas Height= n 40 M > 

<!- Rectangle #1 is filled with a LinearGradientBrush. The gradient colors 
flow from left to right by default. --> 

<Rectangle RectangleLeft= n 10" RectangleTop= M 10" 
RectangleWidth= ,, 300" RectangleHeight="200"> 

<Rectangle.Fill> 
<LinearGradientBrush> 

<LinearGradientBrush.GradientStops> 
<GradientStopCollection> 
<GradientStop Color= n red M Offset="07> 
<GradientStop Color="yellow M Offset= n 1" /> 
<GradientStop Color="blue" Offset="0.57> 
<GradientStop Color="white" Offset="0.27> 
</GradientStopCollection> 
</LinearGradientBrush.GradientStops> 

</LinearGradientBrush> 
</Rectangle.Fill> 

</Rectangle> 



<!-- Rectangle #2 is identical to the first rectangle except that the Transform 
property rotates the LinearGradientBrush so that the gradient colors are 
rotated by 45 degrees. --> 

<Rectangle RectangleLeft="320" RectangleTop="10" 
RectangleWidth= n 300 M RectangleHeight="200"> 

<Rectangle.Fill> 
<LinearGradientBrush> 

<LinearGradientBrush.Transform> 

<RotateTransform Angle="45" /> <!-- Rotation angle. -> 
</LinearGradientBrush.Transform> 

<LinearGradientBrush.GradientStops> 
<GradientStopCollection> 
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<GradientStop Color= M red" Offset="07> 
<GradientStop Color^'yellow" Offset= ,, 1 n /> 
<GradientStop Color="blue M Offset="0.57> 
<GradientStop Color^white" Offset="0.27> 
</GradientStopCollection> 
</LinearGradientBrush.GradientStops> 

</LinearGradientBrush> 
</Rectangle.Fill> 

</Rectangle> 



<!- Rectangle #3 is filled with a RadialGradientBrush. -> 

<Rectangle RectangleLeft="10 n RectangleTop="250" 
RectangleWidth="300" RectangleHeight= n 200 M > 

<Rectangle.Fill> 

<RadialGradientBrush Focus= M 0.5 ) 0.5"> 

<RadialGradientBrush.GradientStops> 
<GradientStopCollection> 
<GradientStop Color="red M Offset="07> 
<GradientStop Color^'yellow" 0ffset="17> 
<GradientStop Color="blue" Offset="0.57> 
</GradientStopCollection> 
</RadialGradientBrush.GradientStops> 

</RadialGradientBrush> 
</Rectangle.Fill> 

</Rectangle> 



<!« Rectangle #4 is identical to the third rectangle except that the Transform 
property applies a ScaleTransform to the RadialGradientBrush so that the 
gradient is half its previous height. -> 

<Rectangle RectangleLeft= ,, 320" RectangleTop="250" 
RectangleWidth="300" RectangleHeight="200"> 

<Rectangle.Fill> 

<RadialGradientBrush Focus^'O.S.O.S'^ 
<RadialGradientBrush.Transform> 

<ScaleTransform ScaleX='T ScaleY="0.5" /><!- Scale transform. -> 
</RadialGradientBrush.Transform> 

<RadialGradientBrush.GradientStops> 
<GradientStopCollection> 
<GradientStop Color="red" Offset="07> 
<GradientStop Color="yellow" Offset="17> 
<GradientStop Color="blue" Offset= ,, 0.5 , 7> 
</GradientStopCollection> 
</RadialGradientBrush.GradientStops> 
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</RadialGradientBrush> 
</Rectangle.Fill> 

</Rectangle> 

</Canvas> 
</Border> 

This example shows how to apply a ScaleTransform when an event occurs. The concept is the same for 
applying other types of transformations. See the Transform class for more information about the available 
types of transformations. 

To apply a specific transformation to an element, you must create a TransformDecorator that you will add 
to that element. In markup, wrap the element with the TransformDecorator When the event occurs, set 
the TransformProperty property of the TransformDecorator to the appropriate transformation, in this case 
a ScaleTransform. 

<Canvas ID-"root" 
xmlns="http://schemas.microsoft.com/2003/xamir 
xmlns:def="Definition M > 

<TransformDecorator ID="tdr AffectsLayout="false"> 

<Button ID= ,, Button1" MouseEnter= M Enter" MouseLeave="Leave">Button</Button> 
</TransformDecorator> 



<![CDATA[ 

Private Sub Enter(ByVal sender as object, ByVal args as MSAvalon.Windows.lnputMouseEventArgs) 

Dim scaler As new ScaleTransform(2,2) 

td1 Transform = scaler 
End Sub 

Private Sub Leave(ByVal sender as object, ByVal e as MSAvalon.Windows.lnput.MouseEventArgs) 

Dim scaler As new ScaleTransform(1,1) 

tdl Transform = scaler 
End Sub 



<def:Code> 



]]> 



</def:Code> 



</Canvas> 



TransformCollection Class 

Definition: Used to create and manipulate a list of Transform objects. 



Method 



Description 



Add 



Adds a Transform object to the end of the collection. 

Adds a Matrix or a set of matrix values to the collection and returns 
the index position at which the object was added. 

Adds the transformations contained in the passed 
TransformCollection to the current collection. 



Add Matrix 



AddRange 
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AddRotate 

AddScale 

AddSkew 

AddTranslate 
Clear 

CloneCore 

CloneCore 

CloneDownToUnchangeable 

Contains 

Copy 
Copy 

Copy 
CopyTo 

CreateMatrix 

CreateRotation 

CreateScale 

CreateSkew 

CreateTranslation 

DisableCore 

Dispose 

Em bedded An imationCollection Reader 

EmbeddedAnimationCollectionWriter 

EmbeddedChangeableReader 

EmbeddedChangeableWriter 

EnableCore 

Equals 

Finalize 

GetCurrentValue 



Constructs and adds 
location at which the 

Constructs and adds 
location at which the 

Constructs and adds 
location at which the 

Constructs and adds 
the location at which 



a RotateTransform to the list and returns the 
transformation was added. 

a ScaleTransform to the list and returns the 
transformation was added. 

a SkewTransform to the list and returns the 
transformation was added. 

a TranslateTransform to the list and returns 
the transformation was added. 



Removes all transformations from the collection. 
Returns a modifiable shallow or deep clone of the current object. 
This abstract method must be implemented by classes that derive 
from Changeable. Inherited from Changeable. 

Implementation of Animatable.CloneCore. 

Returns an immutable copy of the specified object. Inherited from 
Changeable. 

Returns a Boolean that indicates whether the specified 
transformation is contained within the collection. 

Creates a copy of this Transform. Inherited from Transform. 
Creates a copy of this TransformCollection. 
Returns a modifiable copy of the current object. The copy's 
IsChangeable property is true and its StatusOfNextUse is 
Unchangeable. Inherited from Changeable. 

Copies the entire TransformCollection to a compatible one- 
dimensional Array, starting at the specified index of the target 
array. 

Creates an arbitrary affine transformation matrix used for 
transformations in a two-dimensional plane. Inherited from 
Transform. 

Creates a transformation used for rotation in a two-dimensional 
plane. Inherited from Transform. 

Creates a transformation used for scaling in a two-dimensional 
plane. Inherited from Transform. 

Creates a transformation used for skewing in a two-dimensional 
plane. Inherited from Transform. 

Creates a transformation used for translating in the x- and y- 
directions in a two-dimensional plane. Inherited from Transform. 

Dispose resources associated with transform. Inherited from 
Transform. 

Maybe this should be internal?? Inherited from Animatable. 
Inherited from Animatable. 
Inherited from Animatable. 
Inherited from Animatable. 

Determines whether two Object instances are equal. Inherited from 
Object. 

Inherited from Transform. 

Creates a non-animated copy of this Transform with all of its base 
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GetCurrentValue 

GetCurrentValue 

GetEnumerator 
GetHasAnimations 

GetHashCode 

GetlsAn imating 

GetlsOverridingBaseValue 

GetOptimizedTransform 

GetRange 

GetType 

lAddChild.AddChild 

lAddChild.AddText 

I List. Add 

IList.Contains 

IList.lndexOf 

IList.lnsert 

I List. Remove 

IndexOf 

Insert 

InsertRange 
LastlndexOf 

MakeUnchangeable 

MakeUnchangeableCore 
MemberwiseClone 

ModifyHandlerlfChangeable 
OnChanged 

PropagateEventHandler 



values set to the current animated values. Inherited from 
Transform. 

Returns a non-animated version of this Animatable that represents 
its current state. Inherited from Animatable. 

Returns a non-animated version of this TransformCollection that 
represents its current state. 

Returns an enumerator that can iterate through the 
TransformCollection. 

Inherited from Transform. 

Serves as a hash function for a particular type, suitable for use in 
hashing algorithms and data structures like a hash table. Inherited 
from Object. 

Inherited from Transform. 
Inherited from Transform. 

Collapse transformation list to a base transformation. 

Gets the Type of the current instance. Inherited from Object. 



Returns the index of the specified Transform if it exists in the 
collection or part of the collection. If the Transform isn't in the 
collection, this method returns -1. 

Inserts a Transform object into the collection at the specified index. 
Inserts the Transform objects contained within the specified 
TransformCollection into the collection at the specified zero-based 
index. 

Searches for the specified Transform and returns the zero-based 
index of the last occurrence within all or part of the 
TransformCollection. 

Makes an object immutable; after this method is called on a 
Changeable, its IsChangeable property is false. Inherited from 
Changeable. 

Implementation of MakeUnchangeableCore. 

Creates a shallow copy of the current Object. Inherited from 
Object. 

Adds or removes a Changed event handler to or from the specified 
Changeable object, if the object is currently modifiable. If the 
specified object is not modifiable — if its IsChangeable property is 
false— this method has no effect. Inherited from Changeable. 
Called when the current object is modified. Classes that derive 
from Changed should call this method after they have been 
modified. Inherited from Changeable. 
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ReadPreamble 

ReferenceEquals 

Remove 

RemoveAt 

RemoveRange 
SetDefaultParentTimeline 

SetDefaultParentTimeline 

SetDefaultParentTimelineCore 
SetRange 

ToString 

TransformCollection 
ValidateObjectState 

WritePostscript 
WritePreamble 



Ensures that simple (non-Changeable) members are being 
accessed from a valid Ul context. This method should be called 
before any simple members are accessed. Inherited from 
Changeable. 

Determines whether the specified Object instances are the same 
instance. Inherited from Object. 

Removes the specified Transform object from the collection, if it 
exists. 

Removes the Transform object at the specified index from the 
collection. 

Removes the specified number of Transform objects from the 
section of the collection that starts at the specified index. 
Inherited from Transform. 

This will change the time parent for animations on any of the 
properties of this Changeable which are inheriting their time 
parent. Inherited from Animatable. 

Copies the Transform objects of a TransformCollection over a 
range of objects in the current collection. 

Not implemented. Use Object.ToString instead. Inherited from 
Transform. 

Initializes a new instance of the TransformCollection class. 

Verifies that the current object has a valid state. If the object is in 
an invalid state, this method throws an exception. Inherited from 
Changeable. 

Causes the current object to validate itself and then invokes the 
OnChanged method. Inherited from Changeable. 

Ensures that simple (non-Changeable) members are being 
accessed from a valid user interface (Ul) context. This method 
should be called before any simple members are set. Inherited 
from Changeable. 



Property Description 

Used in conjunction with the ChangeableUsageOverride type sent in 

AllowChangeableReferenceOverride * s a P arameter t0 ChangeableHelper.UseChangeable, to help 

determine when a Changeable being put into "use 1 ' should be 
promoted to "ChangeableReference". Inherited from Changeable. 

True if this Changeable can be made unchangeable. Inherited from 
Changeable. 

Gets or sets the number of items the collection can store. 
Gets the number of transformations contained in the Count. 
The current parent Timeline associated with this Animatable. This 
will be the Timeline set to the ParentTimeline property of this 
Animatable if one has been set and if not, the Timeline last passed 
into the SetDefaultParentTimeline method. Inherited from 
Animatable. 

Gets a Boolean that indicates whether any of the transformations in 
the collection have animations. 

Identity transformation. Inherited from Transform. 

Returns true if the list contains transforms that contain active 



CanMakeUnchangeable 

Capacity 
Count 



DefaultParentTimeline 



HasAnimations 

Identity 
IsAnimating 
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animations. 



IsChangeable 



Gets a Boolean that indicates whether the object is currently 
modifiable. Inherited from Changeable. 



IsFixedSize 

IsOverridingBaseValue 



Item 



Gets or sets the transformation at the specified index in the 
transformation list. 



Value 



StatusOfNextUse 



UlContext 



Gets or sets a UseStatus enumeration that specifies how the 
Changeable object behaves when it is "used." A Changeable object 
is considered used in the following situations: the object is set into a 
Property System property, the object is used as a sub-object in a 
complex Changeable object, or the object is used in a 
DrawingContext command. Inherited from Changeable. 
Gets the UlContext of the current object. The UlContext is used for 
maintaining thread safety. Inherited from Changeable. 
Gets the current transformation list as a Matrix object. 



This example specifies scale transformations on several shapes. To transform an element, use a 
TransformDecorator and set its Transform to the transformation you wish to apply. Set the element to 
transform as the TransformDecorator object's Child, and add the TransformDecorator to a panel. The 
ScaleTransform class, one of the transformations you can use with a TransformDecorator, enables you to 
reposition and apply rendering changes elements like Rectangle, Polygon, and Button. 

The ScaleX and ScaleY properties resize an element according to the factor you specify. For example, 
setting ScaleX to 1 .5 resizes the element's x-axis value at 1 50 percent. 

The following example demonstrates a polygon scaled in several ways. The first polygon (black) reflects 
no transformation. 

II #C 

II Create a canvas to contain the shapes. 
Canvas myCanvas = new Canvas(); 

// Create a PointCollection to contain the points of the 
// Polygon shapes. 

PointCollection myPointCollection = new PointCollectionQ; 
myPointCollection.Add(new Point(176.5, 50)); 
myPointCollection. Add(new Point(189, 155)); 
myPointCollection. Add(new Point(286, 113)); 
myPointCollection. Add(new Point(201, 177)); 
myPointCollection.Add(new Point(286, 240)); 
myPointCollection.Add(new Point(189, 198)); 
myPointCollection.Add(new Point(176, 304)); 
myPointCollection. Add(new Point(163, 198)); 
myPointCollection.Add(new Point(66, 240));. 
myPointCollection. Add(new Point(151, 177)); 
myPointCollection. Add(new Point(66, 113)); 
myPointCollection.Add(new Point(163, 155)); 

// Create the first Polygon. 
Polygon firstPolygon = new Polygon(); 
firstPolygon. Points = myPointCollection; 
firstPolygon. Stroke = Brushes.Black; 
firstPolygon.StrokeThickness = new Length(2); 
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myCanvas.Children.Add(firstPolygon); 



1 VB .NET 

1 Create a PointCollection to contain the points of the 
' Polygon shapes. 

Dim myPointCollection As new MSAvalon.Windows.Media.PointCollection 
myPointCollection.Add(new MSAvalon.Windows.Point(176.5, 50)) 
my PointCollection. Add(new MSAvalon.Windows.Point(189, 155)) 
myPointCollection.Add(new MSAvalon. Windows. Point(286, 113)) 
myPointCollection. Add(new MSAvalon.Windows.Point(201, 177)) 
my PointCollection. Add(new MSAvalon. Windows. Point(286, 240)) 
myPointCollection.Add(new MSAvalon.Windows.Point(189, 198)) 
my PointCollection. Add(new MSAvalon.Windows.Point(176, 304)) 
myPointCollection.Add(new MSAvalon.Windows.Point(163, 198)) 
my PointCollection. Add(new MSAvalon. Windows. Point(66, 240)) 
myPointCoIlection.Add(new MSAvalon.Windows.Point(151, 177)) 
myPointCollection.Add(new MS Avalon. Windows. Point(66, 113)) 
myPointCollection. Add(new MSAvalon.Windows.Point(163, 155)) 

' Create the first Polygon. 

Dim firstPolygon As new MSAvalon.Windows.Shapes.Polygon 

firstPolygon. Points = myPointCollection 

firstPolygon. Stroke = MSAvalon.Windows.Media.Brushes.Black 

firstPolygon.StrokeThickness = new MSAvalon.Windows.Length(2) 

myCanvas.Children.Add(firstPolygon) 



The second polygon (blue) is scaled at 50 percent in y and translated by 150 pixels. Because there are 
multiple transformations, a TransformCollection object is used to contain the transformations and set the 
value of the Transform Decorator. Note that the scale transformation affects the element's stroke 
thickness as well as its size. In order to for the TranslateTransform to render, the AffectsLayout property 
of the TransformDecorator must be set to false. 

//C# 

// Create the second Polygon. This polygon contains the same 
// points as the first, but is scaled and translated. 
Polygon secondPolygon = new Polygon(); 
secondPolygon. Points = myPointCollection; 
secondPolygon. Stroke = Brushes.Blue; 
secondPolygon. StrokeThickness = new Length(2); 

// Add a semi-transparent gradient fill to make the shape stand out. 
RadialGradientBrush myGradient = 
new RadialGradientBrush(Colors.Blue, Colors. LimeGreen); 
myGradient.Opacity = 0.4; 
secondPolygon. Fill = myGradient; 

// Create a TransformDecorator to transform secondPolygon. 
TransformDecorator transformer = new TransformDecorator(); 
transformer. AffectsLayout = false; 

// Create the scale and translate transformations. 
ScaleTransform myScaleTransform = new ScaleTransform(1, 0.5); 
TranslateTransform myTranslateTransform = newTranslateTransform(150, 0); 
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//Create a collection to contain the transformations. 
TransformCollection transformations = new TransformCollectionQ; 

transformations.Add(myScaleTransform); 
transformations.Add(myTranslateTransform); 
transformer.Transform = transformations; 

//Add secondPolygon as a child of the TransformDecorator. 
transformer.Child = secondPolygon; 

// Add the decorator to the Canvas. 
myCanvas.Children.Add(transformer); 



■VB.NET 

1 Create the second Polygon. This polygon contains the same 

' points as the first, but is scaled and translated. 

Dim secondPolygon As new MSAvalon.Windows.Shapes.Polygon 

secondPolygon. Points = myPointCollection 

secondPolygon. Stroke = MSAvalon.Windows.Media.Brushes.Blue 

secondPolygon. StrokeThickness = new MSAvalon. Windows. Length(2) 

1 Add a semi-transparent gradient fill to make the shape stand out. 
Dim myGradient As new MSAvalon.Windows.Media.RadialGradientBrush( _ 
Colors.Blue, Colors.LimeGreen) 
myGradient.Opacity = 0.4 
secondPolygon. Fill = myGradient 

' Create a TransformDecorator to transform secondPolygon. 

Dim transformer As new MSAvalon.Windows.Controls.TransformDecorator 

transformer.AffectsLayout = false 

' Create the scale and translate transformations. 

Dim myScaleTransform As new MSAvalon. Windows. Media.ScaleTransform(1, 0.5) 

Dim myTranslateTransform As new MSAvalon.Windows.Media.TranslateTransform(150, 0) 

1 Create a collection to contain the transformations. 

Dim transformations As new MSAvalon.Windows.Media.TransformCollection() 

transformations.Add(myScaleTransform) 
transformations.Add(myTranslateTransform) 
transformer.Transform = transformations 

1 Add secondPolygon as a child of the TransformDecorator. 
transformer.Child = secondPolygon 

' Add the decorator to the Canvas. 
myCanvas.Children.Add(transformer) 

TransformConverter Class 

Definition: Used to convert a Transform object to or from another object type. 

Method Description 

CanConvertFrom Determines whether this class can convert an object of a given type to a 
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CanConvertFrom 
CanConvertTo 

CanConvertTo 

ConvertFrom 
ConvertFrom 

ConvertFromlnvariantString 

ConvertFromString 

ConvertTo 

ConvertTo 

ConvertTolnvariantString 

ConvertToString 

Createlnstance 

Equals 
Finalize 

GetConvertFromException 

GetConvertToException 

GetCreatelnstanceSupported 

GetHashCode 

GetProperties 

GetPropertiesSupported 

GetStandardValues 

GetStandardValuesExclusive 

GetStandardValuesSupported 

GetType 

IsValid 

MemberwiseClone 

ReferenceEquals 

SortProperties 
ToString 

TransformConverter 



Transform type. Currently only string objects can be converted. 
Inherited from TypeConverter. 
Inherited from TypeConverter. 

Determines whether this class can convert an object of a given type to 
the specified destination type. 

Inherited from TypeConverter. 

Converts from an object of a given type to a Transform object. 
Inherited from TypeConverter. 
Inherited from TypeConverter. 
Inherited from TypeConverter. 

Converts the given value object to the specified type, using the specified 
context and culture information. 

Inherited from TypeConverter. 

Inherited from TypeConverter. 

Inherited from TypeConverter. 

Determines whether two Object instances are equal. Inherited from 
Object. 

Allows an Object to attempt to free resources and perform other cleanup 
operations before the Object is reclaimed by garbage collection. Inherited 
from Object. 

Inherited from TypeConverter. 
Inherited from TypeConverter. 
Inherited from TypeConverter. 

Serves as a hash function for a particular type, suitable for use in hashing 
algorithms and data structures like a hash table. Inherited from Object. 
Inherited from TypeConverter. 
Inherited from TypeConverter. 
Inherited from TypeConverter. 
Inherited from TypeConverter. 
Inherited from TypeConverter. 

Gets the Type of the current instance. Inherited from Object. 
Inherited from TypeConverter. 

Creates a shallow copy of the current Object. Inherited from Object. 

Determines whether the specified Object instances are the same 
instance. Inherited from Object. 

Inherited from TypeConverter. 

Returns a String that represents the current Object. Inherited from Object. 
Initializes a new instance of the TransformConverter class as a 
TypeConverter object. 



TranslateTransform Class 

Definition: Translates an object in the two-dimensional x-y plane. 



Method 



CloneCore 



Description 

Returns a modifiable shallow or deep clone of the current 
object. This abstract method must be implemented by classes 



295 



CloneCore 

CloneDownToUnchangeable 

Copy 
Copy 

Copy 

Create Matrix 

CreateRotation 

CreateScale 

CreateSkew 

CreateTranslation 

DisableCore 

Dispose 

EmbeddedAnimationCollectionReader 

EmbeddedAnimationCollectionWriter 

EmbeddedChangeableReader 

EmbeddedChangeableWriter 

EnableCore 

Equals 

Finalize 

GetCurrentValue 
GetCurrentValue 

GetCurrentValue 

GetHasAnimations 

GetHashCode 

GetlsAnimating 

GetlsOverridingBaseValue 

GetType 

MakeUnchangeable 



that derive from Changeable. Inherited from Changeable. 

Implementation of Animatable.CloneCore. 

Returns an immutable copy of the specified object. Inherited 
from Changeable. 

Creates a copy of this TranslateTransform. 
Creates a copy of this Transform. Inherited from Transform. 
Returns a modifiable copy of the current object. The copy's 
IsChangeable property is true and its StatusOfNextUse is 
Unchangeable. Inherited from Changeable. 

Creates an arbitrary affine transformation matrix used for 
transformations in a two-dimensional plane. Inherited from 
Transform. 

Creates a transformation used for rotation in a two-dimensional 
plane. Inherited from Transform. 

Creates a transformation used for scaling in a two-dimensional 
plane. Inherited from Transform. 

Creates a transformation used for skewing in a two-dimensional 
plane. Inherited from Transform. 

Creates a transformation used for translating in the x- and y- 
directions in a two-dimensional plane. Inherited from Transform. 
Inherited from Transform. 

Dispose resources associated with transform. Inherited from 
Transform. 

Maybe this should be internal?? Inherited from Animatable. 
Inherited from Animatable. 
Inherited from Animatable. 
Inherited from Animatable. 
Inherited from Transform. 

Determines whether two Object instances are equal. Inherited 
from Object. 

Inherited from Transform. 

Returns a non-animated version of this TranslateTransform that 
represents its current state. 

Returns a non-animated version of this Animatable that 
represents its current state. Inherited from Animatable. 

Creates a non-animated copy of this Transform with all of its 
base values set to the current animated values. Inherited from 
Transform. 

Inherited from Transform. 

Serves as a hash function for a particular type, suitable for use 
in hashing algorithms and data structures like a hash 
table. Inherited from Object. 

Inherited from Transform. 

Inherited from Transform. 

Gets the Type of the current instance. Inherited from Object. 
Makes an object immutable; after this method is called on a 
Changeable, its IsChangeable property is false. Inherited from 
Changeable. 
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MakeUnchangeableCore 
MemberwiseClone 

ModifyHandlerlfChangeable 

OnChanged 
PropagateEventHandler 

ReadPreamble 

ReferenceEquals 

SetDefaultParentTimeline 

SetDefaultParentTimeline 
SetDefaultParentTimelineCore 

ToString 

TranslateTransform 
ValidateObjectState 

WritePostscript 
WritePreamble 



Implementation of MakeUnchangeableCore. Inherited from 
Transform. 

Creates a shallow copy of the current Object. Inherited from 
Object. 

Adds or removes a Changed event handler to or from the 
specified Changeable object, if the object is currently 
modifiable. If the specified object is not modifiable— if its 
IsChangeable property is false — this method has no 
effect. Inherited from Changeable. 

Called when the current object is modified. Classes that derive 
from Changed should call this method after they have been 
modified. Inherited from Changeable. 

Ensures that simple (non-Changeable) members are being 
accessed from a valid Ul context. This method should be called 
before any simple members are accessed. Inherited from 
Changeable. 

Determines whether the specified Object instances are the 
same instance. Inherited from Object. 

This will change the time parent for animations on any of the 
properties of this Changeable which are inheriting their time 
parent. Inherited from Animatable. 

Inherited from Transform. 

Inherited from Transform. 

Not implemented. Use Object.ToString instead. Inherited from 
Transform. 

Initializes a new instance of the TranslateTransform class. 
Verifies that the current object has a valid state. If the object is 
in an invalid state, this method throws an exception. Inherited 
from Changeable. 

Causes the current object to validate itself and then invokes the 
OnChanged method. Inherited from Changeable. 
Ensures that simple (non-Changeable) members are being 
accessed from a valid user interface (Ul) context. This method 
should be called before any simple members are set. Inherited 
from Changeable. 



Property Description 

Used in conjunction with the ChangeableUsageOverride type sent in 

AllowChangeableReferenceOverride * s a P arameter to ChangeableHelper.UseChangeable, to help 

determine when a Changeable being put into "use" should be 
promoted to "ChangeableReference". Inherited from Changeable. 

True if this Changeable can be made unchangeable. Inherited from 
Changeable. 

The current parent Timeline associated with this Animatable. This 
will be the Timeline set to the ParentTimeline property of this 
Animatable if one has been set and if not, the Timeline last passed 
into the SetDefaultParentTimeline method. Inherited from 
Animatable. 

Gets a Boolean that indicates whether the transformation has 



CanMakeUnchangeable 



DefaultParentTimeline 



HasAnimations 
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animations. 

Identity transformation. Inherited from Transform. 

Returns true if the transformation contains active animations. 

Gets a Boolean that indicates whether the object is currently 
modifiable. Inherited from Changeable. 

Gets or sets a UseStatus enumeration that specifies how the 
Changeable object behaves when it is "used." A Changeable object 
is considered used in the following situations: the object is set into a 
Property System property, the object is used as a sub-object in a 
complex Changeable object, or the object is used in a 
DrawingContext command. Inherited from Changeable. 
Gets the UlContext of the current object. The UlContext is used for 
maintaining thread safety. Inherited from Changeable. 

Gets the current translation transformation as a Matrix object. 

Gets or sets the x-direction component of the translation. 

Gets or sets a collection of DoubleModifier objects that animate the 
transformation's x-axis displacement. 

Gets or sets the y-direction component of the translation. 
Gets or sets a collection of DoubleModifier objects that animate the 
transformation's y-axis displacement. 

TranslateTransform defines an axis-aligned translation in the x and y directions. The static matrix 
representation for a translation by offset (dx, dy) is as follows: 

To translate a Shape element, use a TransformDecorator. 

This example specifies translation transforms on several shapes. The Transform class enables you to 
reposition and apply rendering changes to shape elements like Rectangle, Polygon, and Ellipse. 
The translate value setting repositions the current coordinate system, locating the new origin of that 
coordinate system at the specified values. In the following example, two Polyline shapes indicate the 
original coordinate system and a translation to (50, 50). 

<Canvas ID="root" 

xmlns="http://schemas.microsoft.com/2003/xamr'> 

<!-- No translation -> 
<Polyline ID="angle1" 
Stroke="red" 
StrokeThickness="10" 
Points="10,160 10,10 160,10"> 
</Polyline> 

<!- Translation in x- and y- axes. -> 
<TransformDecorator Affectsl_ayout="false"> 
<TransformDecorator.Transform> 
<TransformCollection > 

<TranslateTransform X="50" Y="50" /> 
</TransformCollection> 
</T ransformDecorator.Transform> 

<Polyline ID="angle2" 
Stroke="blue" 



Identity 
IsAnimating 

IsChangeable 

I sO verrid i ng BaseValue 

StatusOfNextUse 

UlContext 

Value 
X 

XAnimations 
Y 

YAnimations 
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StrokeThickness= ,, 10" 
Points="10,160 10,10 160,10 H > 
</Polyline> 

</T ransformDecorator> 

</Canvas> 

When using translations with other transformations, consider how the translation will affect the 
computation of those transformations. For example, consider a shape positioned at (100, 100). If the 
coordinate system is rotated by thirty degrees, the shape occupies a different screen position than if it 
had been positioned at (0, 0) when the rotation was computed. 

<DockPanel ID="root" 

xmlns= n http://schemas.microsoft.com/2003/xaml"> 

<!-- Shape with no transformation — > 
<Polyline ID="box1" 
Stroke="black" 
StrokeThickness="5" 

Points= M 0,0 10,10 10,50 50,50 50,10 10,10"/> 

<!-- Translation only --> 
<TransformDecorator AffectsLayout="false"> 
<TransformDecorator.Transform> 
<TransformCollection > 

<TranslateTransform X="100" Y="100" /> 
</TransformCollection> 
<ATransformDecorator.Transform> 
<Polyline ID= M box2 ,, 
Stroke="red" 
StrokeThickness="5" 

Points="0,0 10,10 10,50 50,50 50,10 10,10"> 
</Polyline> 

</T ransformDecorator> 

<!- Rotate at origin, then translate -> 

<Transform Decorator AffectsLayout= M false"> 
<TransformDecorator.Transform> 
<TransformCollection > 

<RotateTransform Center="0 0" Angle= H -30 M /> 
<TranslateTransform X="100 ,, Y="100" /> 
</TransformCollection> 
</Transform Decorator. Transform> 
<Polyline ID="box3 M 
Stroke="blue n 
StrokeThickness="5" 

Points="0,0 10,10 10,50 50,50 50,10 10,10"> 
</Polyline> 

</T ransformDecorator> 

<!- Translate, then rotate the new coordinate system (note the different 
element position) --> 

<TransformDecorator AffectsLayout= ,, false"> 

<Transform Decorator. Transform> 
<TransformCollection > 
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<TranslateTransform X= ,, 100" Y="100" /> 
<RotateTransform Center="0 0" Angle= M -30" /> 
</T ransformCollection> 
</T ransformDecorator.Transform> 
<Polyline ID="box4" 
Stroke-'orange" 
StrokeThickness= ,, 5" 

Points="0,0 10,10 10,50 50,50 50,10 10,10'*> 
</Polyline> 

</TransformDecorator> 



</DockPanel> 



For many rotation, scale, and skew transformations, it can be helpful to translate a positioned element to 
the origin, apply the rotation, scale, or skew value, and then translate the element back to its intended 
screen position. This practice makes it less cumbersome to account for specific element positions across 
transformations because transformed elements reflect specific positioning values explicitly set in markup. 



Typeface Class 

Definition: A Typeface is a combination of family, weight, style and stretch. 



Method 

Equals 
Finalize 

GetAdaptiveLayoutMetrics 

GetHashCode 

GetType 

MemberwiseClone 
ReferenceEquals 
ToString 
Typeface 



Description 

Equality check 

Allows an Object to attempt to free resources and perform other cleanup 
operations before the Object is reclaimed by garbage collection. Inherited 
from Object. 

Get font BlackRiver metrics for adaptive layout process 

Create correspondent hash code for the object 

Gets the Type of the current instance. Inherited from Object. 

Creates a shallow copy of the current Object. Inherited from Object. 

Determines whether the specified Object instances are the same 

instance. Inherited from Object. 

Returns a String that represents the current Object. Inherited from Object. 
Construct a typeface 



Property 

CapsHeight 

FontFamily 

Stretch 

StrikeoutPosition 

StrikeoutThickness 

Style 

UnderlinePosition 
UnderlineThickness 
Weight 
XHeight 



Description 

Distance from baseline to top of English capital, relative to em size. 
Font family 

Font Stretch (narrow, wide, etc.) 

Distance from baseline to strike-through position 

strike-through thickness 

Font style (italic, oblique) 

Distance from baseline to underline position 

Underline thickness 

Font weight (light, bold, etc.) 

(Western) x-height relative to em size. 
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VectorC Itection Class 



Meth d 

Add 

AddRange 

Clear 

CloneCore 

CloneDownToUnchangeable 

Contains 
Copy 

Copy 

CopyTo 



Descripti n 



Returns an immutable copy of the specified object. Inherited from 
Changeable. 



Returns a modifiable copy of the current object. The copy's 
IsChangeable property is true and its StatusOfNextUse is 
Unchangeable. Inherited from Changeable. 



Accesses the specified Changeable data member, processes it, and 
returns a reference to the member. This reference should then be 
EmbeddedChangeableReader reassigned to the original member variable. Classes that derive from 

Changeable call this method on data members before they can be 
retrieved through property calls. Inherited from Changeable. 
Processes a modified Changeable data member and returns a 
reference to the processed object. Inherited from Changeable. 

Determines whether two Object instances are equal. Inherited from 
Object. 

Allows an Object to attempt to free resources and perform other 
cleanup operations before the Object is reclaimed by garbage 
collection. Inherited from Object. 



EmbeddedChangeableWriter 
Equals 

Finalize 



GetEnumerator 

GetHashCode 

GetRange 
GetType 

lAddChild.AddChild 

lAddChild.AddText 

IListAdd 

IList.Contains 

IList.lndexOf 

IList.lnsert 

IList.Remove 

IndexOf 

Insert 

InsertRange 
LastlndexOf 

MakeUnchangeable 



Serves as a hash function for a particular type, suitable for use in 
hashing algorithms and data structures like a hash table. Inherited from 
Object. 

Gets the Type of the current instance. Inherited from Object. 



Makes an object immutable; after this method is called on a 
Changeable, its IsChangeable property is false. Inherited from 
Changeable. 
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MakeUnchangeableCore 
MemberwiseClone 

ModifyHandlerlfChangeable 
OnChanged 

PropagateEventHandler 
ReadPreamble 



ReferenceEquals 

Remove 
RemoveAt 
RemoveRange 
SetRange 

ToString 



ValidateObjectState 

VectorCollection 
WritePostscript 

WritePreamble 



Makes a Changeable object immutable. Inherited from Changeable. 
Creates a shallow copy of the current Object. Inherited from Object. 
Adds or removes a Changed event handler to or from the specified 
Changeable object, if the object is currently modifiable. If the specified 
object is not modifiable — if its IsChangeable property is false — this 
method has no effect. Inherited from Changeable. 

Called when the current object is modified. Classes that derive from 
Changed should call this method after they have been 
modified. Inherited from Changeable. 

Shares a Changed event handler with the current object's data 
members or removes it. Inherited from Changeable. 
Ensures that simple (non-Changeable) members are being accessed 
from a valid Ul context. This method should be called before any simple 
members are accessed. Inherited from Changeable. 

Determines whether the specified Object instances are the same 
instance. Inherited from Object. 



Returns a String that represents the current Object. Inherited from 
Object. 

Verifies that the current object has a valid state. If the object is in an 
invalid state, this method throws an exception. Inherited from 
Changeable. 

Causes the current object to validate itself and then invokes the 
OnChanged method. Inherited from Changeable. 

Ensures that simple (non-Changeable) members are being accessed 
from a valid user interface (Ul) context. This method should be called 
before any simple members are set. Inherited from Changeable. 



Property 



Description 

Used in conjunction with the ChangeableUsageOverride type sent in 



AllowChangeableReferenceOverride * s a P arameter t0 ChangeableHelper.UseChangeable, to help 

determine when a Changeable being put into "use" should be 



CanMakeUnchangeable 

Capacity 
Count 

IsChangeable 

IsFixedSize 
Item 



StatusOfNextUse 



promoted to "ChangeableReference". Inherited from Changeable. 

True if this Changeable can be made unchangeable. Inherited from 
Changeable. 



Gets a Boolean that indicates whether the object is currently 
modifiable. Inherited from Changeable. 



Gets or sets a UseStatus enumeration that specifies how the 
Changeable object behaves when it is "used." A Changeable object 
is considered used in the following situations: the object is set into a 
Property System property, the object is used as a sub-object in a 
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complex Changeable object, or the object is used in a 
DrawingContext command. Inherited from Changeable. 

UlContext Gets the UIContext of the current object. The UlContext is used for 

maintaining thread safety. Inherited from Changeable. 



VectorCollectionConverter Class 

Definition: VectorCollectionConverter - Converter class for converting instances of other types to and from 
VectorCollection instances. 



Method 

CanConvertFrom 

CanConvertFrom 
CanConvertTo 

CanConvertTo 

ConvertFrom 

ConvertFrom 

ConvertFromlnvariantString 

ConvertFromString 

ConvertTo 

ConvertTo 

ConvertTolnvariantString 

ConvertToString 

Createlnstance 

Equals 
Finalize 

GetConvertFromException 

GetConvertToException 

GetCreatelnstanceSupported 

GetHashCode 

GetProperties 

GetPropertiesSupported 

GetStandardValues 

GetStandardValuesExclusive 

GetStandardValuesSupported 

GetType 

IsValid 

MemberwiseClone 
ReferenceEquals 



Description 

CanConvertFrom - Returns whether or not this class can convert from a 
given type. 

Inherited from TypeConverter. 
Inherited from TypeConverter. 

CanConvertTo - Returns whether or not this class can convert to a given 
type. 

Inherited from TypeConverter. 

ConvertFrom - Attempt to convert to a VectorCollection from the given 
object 

Inherited from TypeConverter. 
Inherited from TypeConverter. 
Inherited from TypeConverter. 

ConvertTo - Attempt to convert a VectorCollection to the given type 
Inherited from TypeConverter. 
Inherited from TypeConverter. 
Inherited from TypeConverter. 

Determines whether two Object instances are equal. Inherited from 
Object. 

Allows an Object to attempt to free resources and perform other cleanup 
operations before the Object is reclaimed by garbage 
collection. Inherited from Object. 

Inherited from TypeConverter. 

Inherited from TypeConverter. 

Inherited from TypeConverter. 

Serves as a hash function for a particular type, suitable for use in 
hashing algorithms and data structures like a hash table. Inherited from 
Object. 

Inherited from TypeConverter. 
Inherited from TypeConverter. 
Inherited from TypeConverter. 
Inherited from TypeConverter. 
Inherited from TypeConverter. 

Gets the Type of the current instance. Inherited from Object. 
Inherited from TypeConverter. 

Creates a shallow copy of the current Object. Inherited from Object. 

Determines whether the specified Object instances are the same 
instance. Inherited from Object. 
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SortProperties 
ToString 

VectorCollectionConverter 



Inherited from TypeConverter. 

Returns a String that represents the current Object. Inherited from 
Object. 



! 



VideoData Class 

Definition: Enables playing of video files according to the state of a time node. 



Method 



Beginln 
CloneCore 



CloneDownToUnchangeable 
Copy 

Disable 
Dispose 

EmbeddedChangeableReader 

EmbeddedChangeableWriter 

Enable 

Endln 

Equals 

Finalize 

GetHashCode 

GetType 

MakeUnchangeable 

MakeUnchangeableCore 
MemberwiseClone 

ModifyHandlerlfChangeable 



Description 

Schedules an interactive begin time. Inherited from MediaData. 
Clones this MediaData. 

Returns an immutable copy of the specified object. Inherited from 
Changeable. 

Returns a modifiable copy of the current object. The copy's 
IsChangeable property is true and its StatusOfNextUse is 
Unchangeable. Inherited from Changeable. 

Disables this timeline, after which the timeline can no longer become 
active. The timeline can be re-enabled with a call to Enable. Inherited 
from MediaData. 

Dispose the object. Inherited from MediaData. 

Accesses the specified Changeable data member, processes it, and 
returns a reference to the member. This reference should then be 
reassigned to the original member variable. Classes that derive from 
Changeable call this method on data members before they can be 
retrieved through property calls. Inherited from Changeable. 

Processes a modified Changeable data member and returns a 
reference to the processed object. Inherited from Changeable. 
Enables this timeline, parenting it to the timeline specified by the 
ParentTimeline property. This allows the timeline to become active. 
This method throws an exception if the ParentTimeline property is 
null. Inherited from MediaData. 

Schedules an interactive end time. Inherited from MediaData. 

Determines whether two Object instances are equal. Inherited from 
Object. 

Finalizes the MediaData. Inherited from MediaData. 
Serves as a hash function for a particular type, suitable for use in 
hashing algorithms and data structures like a hash table. Inherited 
from Object. 

Gets the Type of the current instance. Inherited from Object. 
Makes an object immutable; after this method is called on a 
Changeable, its IsChangeable property is false. Inherited from 
Changeable. 

Implementation of MakeUnchangeableCore. Inherited from 
MediaData. 

Creates a shallow copy of the current Object. Inherited from Object. 
Adds or removes a Changed event handler to or from the specified 
Changeable object, if the object is currently modifiable. If the specified 
object is not modifiable — if its IsChangeable property is false — this 
method has no effect. Inherited from Changeable. 
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OnChanged 

Pause 
Play 

PropagateEventHandler 
ReadPreamble 

ReferenceEquals 

Resume 

Seek 

ToString 

ValidateObjectState 

VideoData 
WritePostscript 

WritePreamble 



Called when the current object is modified. Classes that derive from 
Changed should call this method after they have been 
modified. Inherited from Changeable. 

Pauses this media. Inherited from MediaData. 

Begins playback of media. Inherited from MediaData. 

Propogates event handler to the timeline Inherited from MediaData. 

Ensures that simple (non-Changeable) members are being accessed 

from a valid user interface (Ul) context. This method should be called 

before any simple members are accessed. Inherited from 

Changeable. 

Determines whether the specified Object instances are the same 
instance. Inherited from Object. 

Resumes this media. Inherited from MediaData. 

Moves the timeline for this media. Inherited from MediaData. 

Persist MediaData in a string Inherited from MediaData. 

Verifies that the current object has a valid state. If the object is in an 

invalid state, this method throws an exception. Inherited from 

Changeable. 

Initializes a new instance of the VideoData class. 

Causes the current object to validate itself and then invokes the 

OnChanged method. Inherited from Changeable. 

Ensures that simple (non-Changeable) members are being accessed 

from a valid Ul context. This method should be called before any 

simple members are set. Inherited from Changeable. 



Property 

Acceleration 

AllowChangeableReferenceOverride 

AutoReverse 
Begin 

CanMakeUnchangeable 

CurrentRepeat 
CurrentTime 

Deceleration 

Duration 
End 

EndSync 
Fill 

FillDefault 
HasAudio 
HasChanged 



Description 

Accesses the Acceleration SMIL attribute. Inherited from 
MediaData. 

Used in conjunction with the ChangeableUsageOverride type sent in 
as a parameter to ChangeableHelper.UseChangeable, to help 
determine when a Changeable being put into "use" should be 
promoted to "ChangeableReference' 1 . Inherited from Changeable. 

Accesses the AutoReverse SMIL attribute. Inherited from 
MediaData. 

Accesses the Begin SMIL attribute. Inherited from MediaData. 

True if this Changeable can be made unchangeable. Inherited from 
Changeable. 

The current repetition iteration. Inherited from MediaData. 

The current time local to this media. Inherited from MediaData. 

Accesses the Deceleration SMIL attribute. Inherited from 
MediaData. 

Accesses the Duration SMIL attribute. Inherited from MediaData. 
Accesses the End SMIL attribute. Inherited from MediaData. 
Accesses the EndSync SMIL attribute. Inherited from MediaData. 
Accesses the Fill SMIL attribute. Inherited from MediaData. 
Accesses the FillDefault SMIL attribute. Inherited from MediaData. 
True if the media has audio output. Inherited from MediaData. 
True if the media has changed since the last tick. Inherited from 
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HasVideo 
Height 

IsChangeable 

IsChanging 

IsEnabled 

IsForwardProgressing 

IsOverridingBaseValue 

IsPaused 

IsReversed 

MediaDuration 

Mute 

ParentTimeline 
Progress 

RepeatCount 

RepeatDuration 

Restart 

RestartDefault 

Speed 
State 



StatusOfNextUse 



UlContext 

Volume 
Width 



Media Data. 

True if the media has a visual output. Inherited from MediaData. 

Get the video Height in pixels Inherited from MediaData. 

Gets a Boolean that indicates whether the object is currently 
modifiable. Inherited from Changeable. 

True if the media is active, false otherwise. Inherited from 
MediaData. 

True if the media is enabled, false otherwise. Inherited from 
MediaData. 

True if the media is moving from past to future. Inherited from 
MediaData. 

True if the media is either changing or in a fill state, false 
otherwise. Inherited from MediaData. 

True if this media is paused. Inherited from MediaData. 

True if this media is in a reverse period. Inherited from MediaData. 

Returns the native media duration. Inherited from MediaData. 

Accesses the mute state of media playback. Inherited from 
MediaData. 

Accesses the ParentTimeline attribute. Inherited from MediaData. 

The current progress of the media, from 0 to 1. Inherited from 
MediaData. 

Accesses the RepeatCount SMIL attribute. Inherited from 
MediaData. 

Accesses the RepeatDuration SMIL attribute. Inherited from 
MediaData. 

Accesses the Restart SMIL attribute. Inherited from MediaData. 

Accesses the RestartDefault SMIL attribute. Inherited from 
MediaData. 

Accesses the Speed SMIL attribute. Inherited from MediaData. 
Returns the current state of the media. Inherited from MediaData. 
Gets or sets a UseStatus enumeration that specifies how the 
Changeable object behaves when it is "used." A Changeable object 
is considered used in the following situations: the object is set into a 
Property System property, the object is used as a sub-object in a 
complex Changeable object, or the object is used in a 
DrawingContext command. Inherited from Changeable. 
Gets the UlContext of the current object. The UlContext is used for 
maintaining thread safety. Inherited from Changeable. 
Accesses the volume of media playback. Inherited from MediaData. 
Get the video Width in pixels Inherited from MediaData. 



VideoDataConverter Class 

Definition: VideoDataConverter 

Method Description 

CanConvertFrom CanConvertFrom 
CanConvertFrom Inherited from TypeConverter. 
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CanConvertTo 
CanConvertTo 
ConvertFrom 
ConvertFrom 

ConvertFromlnvariantString 

ConvertFromString 

ConvertTo 

ConvertTo 

ConvertTolnvariantString 

ConvertToString 

Createlnstance 

Equals 
Finalize 

GetConvertFromException 

GetConvertToException 

GetCreatelnstanceSupported 

GetHashCode 

GetProperties 

GetPropertiesSupported 

GetStandardValues 

GetStandardValuesExclusive 

GetStandardValuesSupported 

GetType 

IsValid 

MemberwiseClone 
ReferenceEquals 
SortProperties 
ToString 

VideoDataConverter 



Inherited from TypeConverter. 
TypeConverter method override. 

Inherited from TypeConverter. 
ConvertFromString 

Inherited from TypeConverter. 

Inherited from TypeConverter. 

Inherited from TypeConverter. 
TypeConverter method implementation. 

Inherited from TypeConverter. 

Inherited from TypeConverter. 

Inherited from TypeConverter. 

Determines whether two Object instances are equal. Inherited from 
Object. 

Allows an Object to attempt to free resources and perform other cleanup 
operations before the Object is reclaimed by garbage 
collection. Inherited from Object. 

Inherited from TypeConverter. 

Inherited from TypeConverter. 

Inherited from TypeConverter. 

Serves as a hash function for a particular type, suitable for use in 
hashing algorithms and data structures like a hash table. Inherited from 
Object. 

Inherited from TypeConverter. 
Inherited from TypeConverter. 
Inherited from TypeConverter. 
Inherited from TypeConverter. 
Inherited from TypeConverter. 

Gets the Type of the current instance. Inherited from Object. 
Inherited from TypeConverter. 

Creates a shallow copy of the current Object. Inherited from Object. 

Determines whether the specified Object instances are the same 
instance. Inherited from Object. 

Inherited from TypeConverter. 

Returns a String that represents the current Object. Inherited from 
Object. 



Visual Class 

Definition: Base class for all Visual types. It provides services and properties common to all Visuals, 
including hit-testing, coordinate transformation, and bounding box calculations. 

Method Description 

ClearValue Clears the local value of a property Inherited from 

O e p enC i enC yObject. 

Equals Determines whether two Object instances are equal. Inherited from 

_ Object. 
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Finalize 
GetHashCode 

GetLocalValueEnumerator 

GetType 
GetValue 

HitTestCore 

InvalidateProperty 

I Visual. FindCommonVisual Ancestor 

IVisual.HitTest 

I Visual. IsAncestorOf 

I Visual. IsDescendantOf 

IVisual.TransformFromAncestor 

IVisual.TransformFromDescendant 

IVisual.TransformFromVisual 

IVisualTransformToAncestor 

IVisual.TransformToDescendant 

IVisual.TransformToVisual 

MemberwiseClone 
OnDelayedlnvalidate 
OnPropertylnvalidated 
Read Local Value 
ReferenceEquals 
SetContext 
SetValue 
ToString 
ValidateProperty 
ValidatePropertyCore 
Visual 



Releases all resources held by the Visual object. 
Serves as a hash function for a particular type, suitable for use in 
hashing algorithms and data structures like a hash table. Inherited 
from Object. 

Create a local value enumerator for this instance Inherited from 
DependencyObject. 

Gets the Type of the current instance. Inherited from Object. 

Retrieve the value of a property Inherited from DependencyObject. 

HitTestCore implements whether we have hit the bounds of this 
visual. 

Invalidates a property Inherited from DependencyObject. 



Creates a shallow copy of the current Object. Inherited from 
Object. 

TODO: Left over from WCP FastBuild, determine relevance in 
future version of FastBuild Inherited from DependencyObject. 

Notification that a specified property has been invalidated Inherited 
from DependencyObject. 

Retrieve the local value of a property (if set) Inherited from 
DependencyObject. 

Determines whether the specified Object instances are the same 
instance. Inherited from Object. 

Associates this UlContextObject with a UlContext. Inherited from 
UlContextObject. 

Sets the local value of a property Inherited from 
DependencyObject. 

Returns a String that represents the current Object. Inherited from 
Object. 

Retrieve the value of a property (for use by native cache backed 
custom get accessors) Inherited from DependencyObject. 
Allows subclasses to participate in property value 
computation Inherited from DependencyObject. 
Creates a new instance of the Visual class. 



Property Description 

Context Returns the UlContext that this UlContextObject is associated with. Inherited 

from UlContextObject. 

DependencvObiectTvoe Retums the DT yP e th a* represents the CLR type of this instance Inherited from 
y J yy DependencyObject. 
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HitTestBounds HitBounds returns the hit region bounding box for the current visual. 

IsDisposed Gets a value that indicates whether the system has disposed of the Visual. 



This example demonstrates how to use a PrintContext object to write to a printer. 
The following code demonstrates how to print a Visual (the VectorPage in this example) to the default 
printer. The VectorPage in this example derives from DrawingVisual and is used to draw several shapes. 
Two VectorPage objects are printed by calling the AddPage method twice. 
[C#] 



public static void PrintPaginatedVisualToDefaultPrinter() { 
// create a print context for my default printer 
MSAvalon.Windows.Media. PrintContext pc = 
new MSAvalon. Windows. Media. PrintContext(); 

// Add two pages to the default rendition 
pc.AddPage(new VectorPage()); 
pc.AddPage(new VectorPageQ); 

//Print 
pc.Print(); 

} 

The next example demonstrates how to print a Visual to a printer that the user selects. The 
SelectPrintQueue method is used to produce a dialog box that enables the user to select the printer, 
number of copies to print, and other options. 
[C#] 



public static void PrintPaginatedVisualToSelectedPrinter() { 
// Let user select a printer queue using common dialog box 
System.Printing.PrintSubSystem.PrintQueue queue = 
MSAvalon.Windows.Media.PrintContext.SelectPrintQueue(); 

if (queue != null) { 

// Create MSAvalon.Windows.Media. PrintContext if OK button was clicked 
MSAvalon.Windows.Media.PrintContext pc = 
new MSAvalon.Windows.Media. PrintContext(queue, "Printing Example"); 

// Add a page of visual 
pc.AddPage(new VectorPage()); 

// Print 
pc.Print(); 

} 

} 

The next example demonstrates how to print to landscape and portrait page orientations. In the following 
code, a JobTicket is obtained and used to set the page orientation. The DimensionPage in this example is 
a DrawingVisual that adjust the size of its drawing to the size of the output page. The 
GetPaperWidthHeight method in this example is used to retrieve the page size information from the 
JobTicket. 
[C#] 

public static void MixedOrientationPrintQ { 
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System. Printing. PrintSubSystem.LocalPrintServer ps = 
new System.Printing.PrintSubSystem.LocalPrintServer(); 

System.Printing.PrintSubSystem.PrintQueue queue = ps.DefaultPrintQueue; 

MSAvalon.Windows.Media.PrintContext pc = 

new MSAvalon.Windows.MediaPrintContext(queue, "Landscape Example"); 

Microsoft.Printing.JobTicket.JobTicket jt = pc.JobTicket; 

// Print a page with landscape orientation. 
{ 

jtPageOrientation. Value = 
System. Printing.Configuration.PrintSchema.OrientationValues. Landscape; 

double width, height; 

GetPaperWidthHeight(pc.JobTicket, queue, out width, out height); 
// Add a page of visual 

pc.AddPage(new DimensionPage(height, width)); 



// Print a page with portrait orientation. 
{ 

jt.PageOrientation.Value = 
System. Printing. Configuration. PrintSchema.OrientationValues.Portrait; 

double width, height; 

GetPaperWidthHeight(pc.JobTicket, queue, out width, out height); 
// Add a page of visual 

pc.AddPage(new DimensionPage(width, height)); 



// Print 
pcPrintO; 

} 

internal static void GetPaperWidthHeight(Microsoft.Printing.JobTicket.JobTicket jt, 

System. Printing. PrintSubSystem.PrintQueue pq, out double width, out double height) { 

Microsoft.Printing.DeviceCapabilities.DeviceCapabilities devcap = 
new Microsoft.Printing.DeviceCapabilities.DeviceCapabilities( 
pq.AcquireDeviceCapabilities(null)); 

devcap.LengthUnitType = System.Printing.Configuration.PrintSchema.LengthUnitTypes.lnch; 

width = (double) devcap.PageCanvasSizeCap.CanvasSizeX * 96; 
height = (double) devcap. PageCanvasSizeCap.CanvasSizeY * 96; 



The next example demonstrates how to print based on the GetPage event. The GeneratePage method is 
used to handle the event 
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[C#] 

public static void EventDriven() { 
System. Printing. PrintSubSystem.LocalPrintServer ps = 
new System. Printing. PrintSubSystem.LocalPrintServer(); 

System. Printing. PrintSubSystem.PrintQueue queue = ps.DefaultPrintQueue; 

// Create MSAvalon.Windows.Media.PrintContext if OK button was clicked 
MSAvalon.Windows.Media.PrintContext pc = 
new MSAvalon.Windows.Media.PrintContext(queue, "EventDriven(2 pages)"); 

pc.GetPage += new MSAvalon.Windows.Media.PrintContext.GetPageEventHandler(GetAPage); 

// Print 
pc.PrintO; 

} 

private static MSAvalon.Windows.Media.Visual GeneratePage(object sender, 
int pageNo, MSAvalon.Windows.Media.GetPageEventArgs ev) { 

if (pageNo == 0) { 
return new VectorPage(); 

} 

else if (pageNo == 1) { 
return new lmagePage(); 

} 

else return null; 

} 

When running the sample and performing this operation, a dialog box with an assertion error message 

may appear. Click the Ignore All button to ignore the assertion and print the pages. 

The final^example shows how to print to a file by using the PrintContext object's Output property. 

public static void PrintToFile() { 
System. Printing. PrintSubSystem.LocalPrintServer ps = 
new System.Printing.PrintSubSystem.LocalPrintServer(); 

System.Printing. PrintSubSystem.PrintQueue queue = ps.DefaultPrintQueue; 

// Create PrintContext if OK button was clicked 
MSAvalon.Windows.Media.PrintContext pc = 
new MSAvalon.Windows.Media.PrintContext(queue, "PrintToFile"); 

pc.Output = "testprn"; 

// Add a page of visual 
pc.AddPage(new VectorPageQ); 

// Print 
pc.Print(); 

} 
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This example demonstrates how to use a PrintContext object to print a rendered "Longhorn" markup 
language (code-named "XAML") file. 

In the following example, the LoadContent method is used to load, parse, and return a "XAML" file's root 
UlElement. The UlElement, page, is then configured with a LayoutManager, added to the PrintContext 
object using the AddPage method, and printed with the Print method. 
[C#] 

public static void PrintXamlFile(string xamlFilePath) { 
// Let user select a printer queue using common dialog box 
System.Printing.PrintSubSystem.PrintQueue queue = 
MSAvalon.Windows.Media.PrintContext.SelectPrintQueue(); 

if (queue != null) { 

MSAvalon. Windows. Media. PrintContext pc = 
new MSAvalon.Windows.Media.PrintContext(queue, "Element printing test"); 

MSAvalon.Windows.UIEIement page = LoadContent(xamlFilePath); 

MSAvalon. Windows. LayoutManager Im = new MSAvalon.Windows.LayoutManager(page); 

double width, height; 

GetPaperWidthHeight(pc.JobTicket, queue, out width, out height); 

Im.Size = new MSAvalon. Windows. Size(width, height); 
lm.UpdateLayout(); 

pc.AddPage(page); 
pc.Print(); 

} 

} 



The LoadContent method used in the previous example is used to load the "XAML" file, parse it, and 
return its root UlElement. The GetPaperWidthHeight method in this example is used to retrieve the page 
size information from the JobTicket. 
[C#] 

public static MSAvalon.Windows.UIEIement LoadContent(string xamlFilePath) { 
System.lO.Stream xamlFileStream = System. lO.File.OpenRead(xamlFilePath); 
MSAvalon.Windows.UIEIement root = null; 
try{ 

MSAvalon.Windows.Serialization.ParserContext pc = 
new MSAvalon. Windows.Serialization. ParserContext(); 

System. Security. PermissionSet ps = 
MSAvalon.Windows.TrustManagement.TrustManager.GetDefaultPermissionsO; 

System. Security. Permissions. FilelOPermission fiop = 
new System. Security.Permissions.FilelOPermission( 
System. Security. Permissions. FilelOPermissionAccess.AIIAccess, 
System.lO.Path.GetFullPath(".\\")); 
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ps.AddPermission(fiop); 



root = 

(MSAvalon.Windows.UIEIement) MSAvalon.Windows.Serialization. Parser. LoadXml( 
xamlFileStream, null, pc, null, ps); 

} 

catch (Exception e) { 
Console. WriteLinefLoad Failed:"); 
Console.WriteLine(e); 

} 

finally { 
// done with the stream 
xamlFileStream.CloseO; 

} 

return root; 

} 



internal static void GetPaperWidthHeight(Microsoft Printing. JobTicket.JobTicket jt, 

System.Printing.PrintSubSystem.PrintQueue pq, out double width, out double height) { 

Microsoft.Printing.DeviceCapabilities.DeviceCapabilities devcap = 
new Microsoft. Printing. DeviceCapabilities.DeviceCapabilities( 
pq.AcquireDeviceCapabilities(null)); 

devcap.LengthUnitType = System.Printing.Configuration.PrintSchema.LengthUnitTypes.lnch; 

width = (double) devcap. PageCanvasSizeCap.CanvasSizeX * 96; 
height = (double) devcap.PageCanvasSizeCap.CanvasSizeY * 96; 

} 



VisualCollection Class 

Definition: An ordered collection of Visual objects. 



Method 

Add 
Clear 

Contains 

CopyTo 
Equals 

Finalize 

GetEnumerator 

GetHashCode 

GetTransform 
GetType 

IndexOf 



Description 

Appends a Visual to the end of the VisualCollection. 
Removes all elements from the VisualCollection. 

Returns a Boolean value that indicates whether the passed Visual is contained in the 
collection. 

Copies the current collection into the passed Array. 
Determines whether two Object instances are equal. Inherited from Object. 
Allows an Object to attempt to free resources and perform other cleanup operations 
before the Object is reclaimed by garbage collection. Inherited from Object. 

Returns an enumerator that can iterate through the VisualCollection. 

Serves as a hash function for a particular type, suitable for use in hashing algorithms 

and data structures like a hash table. Inherited from Object. 

Gets the transform for the specified child. 

Gets the Type of the current instance. Inherited from Object. 

Returns the zero-based index of the Visual. If the Visual is not in the VisualCollection 
-1 is returned. 
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Insert 

MemberwiseClone 

ReferenceEquals 

Remove 

RemoveAt 

RemoveRange 

SetTransform 

ToString 

TrimToSize 



Inserts an element into the VisualCollection at the specified index. 

Creates a shallow copy of the current Object. Inherited from Object. 

Determines whether the specified Object instances are the same instance. Inherited 
from Object. 

Removes the specified visual from the VisualCollection. 
Removes the Visual at the specified index. 
Removes a range of Visuals from the VisualCollection. 
Sets the transform for the specified child. 

Returns a String that represents the current Object. Inherited from Object. 
Sets the capacity to the actual number of elements in the VisualCollection. 



Property Description 

Capacity Gets or sets the number of elements that the VisualCollection can contain. 

Count Gets the number of elements in the collection. 

IsSynchronized Gets a value indicating whether access to the ICollection is synchronized (thread-safe). 

I tem Indexer for the VisualCollection. Gets or sets the Visual stored at the zero-based index of 
the VisualCollection. 

SyncRoot Gets an object that can be used to synchronize access to the ICollection. 



VisualManager Class 

Definition: Renders a tree of Visual objects to a rendering target, typically a window. 



Method 

DeviceUnitsFromMeasureUnits 
Dispose 

Equals 
Finalize 

GetHashCode 

GetType 

HandleMessage 

MeasureUnitsFromDeviceUnits 
MemberwiseClone 

ReferenceEquals 

SetContext 

ToString 

VisualManager 



Description 

Transforms a point in measure units to a point in device coordinates. 

Releases the resources associated with the object. 

Determines whether two Object instances are equal. Inherited from 
Object. 

Allows an Object to attempt to free resources and perform other cleanup 
operations before the Object is reclaimed by garbage collection. Inherited 
from Object. 

Serves as a hash function for a particular type, suitable for use in 
hashing algorithms and data structures like a hash table. Inherited from 
Object. 

Gets the Type of the current instance. Inherited from Object. 

The VisualManager needs to see all windows messages so that it can 
appropriately react to them. 

Transforms a point in device coordinates to a point in measure units. 

Creates a shallow copy of the current Object. Inherited from Object. 

Determines whether the specified Object instances are the same 
instance. Inherited from Object. 

Associates this UlContextObject with a UlContext. Inherited from 
UlContextObject. 

Returns a String that represents the current Object. Inherited from 
Object. 

Attaches a VisualManager to the hWnd 
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Property Descripti n 

BackqroundColor This is the color that is drawn before everything else. If this color has an alpha 
y component other than 1 it will be ignored. 

Context Returns the UlContext that this UlContextObject is associated with. Inherited from 

UlContextObject. 

IsDisposed 

RootVisual Gets and sets the root Visual of this VisualManager. 

The VisualManager is not thread-safe. Accessing the VisualManagerManager from a thread other than 
the thread in which it was created will throw an InvalidOperationException. 

INTERFACES 

Hyphenate Interface 

Definition: IHyphenate is the interface for Hyphenation Service Provider 

Method Description 

Return possible HyphenationCandidate for a given word. Use passed in culture. 
Hyphenate The service provider will check compatibly before it proceed to find hyphenation 
candidates. 



IRetainedRender Interface 

Definition: If this interface is implemented on a class that is derived from a RetainedVisual, the 
RetainedVisual operations in validation mode, i.e. the graphics sub-system will call OnRender in a lazy 
fashion, (e.g. if the Visual appears for the first time on the screen). Note that OnRender can be called by 
the system anytime. 

Method Description 

RonHor The implementation of RenderCore can use the passed in DrawingContext to render this 
"enaer Visuars content 



IVisual Interface 

Definition: This interface defines the common methods and services available from a Visual object. 

Method Description 

FindCommonVisualAncestor Returns the common ancestor of two Visual objects. 
HitTest Return top most visual of a hit test. 

IsAncestorOf Returns true if the Visual is an ancestor of the argument Visual. Inherited 

from . 

IsDescendantOf Returns true if the Visual is a descendant of the argument Visual. Inherited 

from . 

Transform FromAncestor Re tums a transform that can be used to transform coordinates from the 

specified ancestor to this node. Inherited from . 

TransformFromDescendant Returns a transform that can be used to transform coordinate from the 

descendant node to this Visual. Inherited from . 

TransformFromVisual The returned matrix can be used to transform coordiantes from the 

specified Visual to the this Visual. Inherited from . 

TransformToAncestor Returns a transformation matrix that can be used to transform coordinates 
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TransformToDescendant 



TransformToVisual 



from this node to a specified ancestor Visual. Inherited from . j 
Returns a transformation matrix that can be used to transform coordinates ; 
from this node to a specified descendant Visual. Inherited from . ' 
The returned matrix can be used to transform coordiantes from this Visual ! 
to the specified Visual. Inherited from . I 



Property 

Children 
Clip 

HasChildren 

Opacity 
Parent 

VisualContentBounds 



Description 

Gets a collection of the Visual's children. Inherited from . 

Gets or sets the clipping region of this Visual. Inherited from . 

Gets a value that indicates whether the Visual has a child collection. Inherited 
from . 

Gets or sets the opacity of the Visual. Inherited from . 
Gets the parent Visual. Inherited from . 

VisualContentBounds returns the bounding box for the contents of the current 
visual. 



VisualDescendantBounds returns the union of all of the content bounding 
VisualDescendantBounds boxes for all of the descendants of the current visual, but not including the 

contents of the current visual. 
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MSAvalon.Wind ws.Media.Animation 



The following tables list the members exposed by the MSAvalon. Windows. Media. Animation namespace. 



Classes 

Animatable 

AnimationCollection 

AnimationEffect 

AnimationEffectCollection 

BoolAnimationCollection 

BoolModifier 

BoolTimedModifier 

ByteAnimationCollection 

ByteModifier 

ByteTimedModifier 

CharAnimationCollection 

CharModifier 

CharTimedModifier 

ColorAnimation 

ColorAnimationCollection 

ColorKeyFrameCollection 

ColorModifier 

ColorTimedModifier 

DecimalAnimationCollection 

DecimalModifier 

DecimalTimedModifier 

DoubleAnimation 

DoubleAnimationCollection 

DoubleKeyFrameCollection 

DoubleModifier 

DoubleTimedModifier 

FloatAnimation 

FloatAnimationCollection 

FloatKeyFrameCollection 

FloatModifier 

FloatTimedModifier 

IntAnimationCollection 

IntModifier 

IntTimedModifier 

LengthAnimation 



Any class that doesn't derive from DependencyObject but which has properties that 
can be animated should derive from this class. 

This abstract class provides base functionality for animation collections, such as 
ColorAnimationCollection, DoubleAnimationCollection, and 
SizeAnimationCollection. 

Override this class to implement element level animations which can participate in 
the rendering process to instantiate animations on multiple elements at rendering 
time. 

Holds a collection of AnimationEffects. 
Represents a collection of BoolModifier animations. 



Represents a collection of BoolModifier animations. 



Represents a collection of CharModifier animations. 



Animates a color value of a property. 

Represents a collection of ColorModifier animations. 



Represents a collection of DecimalModifier animations. 



Used to animate properties that accept a Double value. 
Represents a collection of DoubleModifier animations. 



Used to animate properties that accept a Single value. 
Represents a collection of FloatModifier animations. 



Represents a collection of IntModifier animations. 



Used to animate properties that accept a Length value. 
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LengthAnimationCollection 

Length Key FrameCollection 

LengthModifier 

LengthTimedModifier 

LongAnimationCollection 

LongModifier 

LongTimedModifier 

MatrixAnimationCollection 

MatrixModifier 

MatrixTimedModifier 

Modifier 

ObjectAnimationCollection 

ObjectModifier 

ObjectTimedModifier 

PathAnimation 

PointAnimation 

PointAnimationCollection 

PointKeyFrameCollection 

PointModifier 

PointTimedModifier 

RectAnimation 

RectAnimationCollection 

RectKeyFrameCollection 

RectModifier 

RectTimedModifier 

ShortAnimationCollection 

ShortModifier 

ShortTimedModifier 

SizeAnimation 

SizeAnimationCollection 

SizeKeyFrameCollection 

SizeModifier 

SizeTimedModifier 

StringAnimationCollection 

StringModifier 

StringTimedModifier 

Timeline 

TimelineBuilder 

TimeManager 

TimeSyncValueTypeConverter 
TimeTypeConverter 
VectorAnimation 
VectorAnimationCollection 



Represents a collection of LengthModifier animations. 



Represents a collection of LongModifier animations. 



Represents a collection of MatrixModifier animations. 



Represents a collection of ObjectModifier animations. 



This animation can be used inside of a MatrixAnimationCollection to move a visual 
object along a path. 

Used to animate properties that accept Point values. 
Represents a collection of PointModifier animations. 



Used to animate properties that accept a Rect value. 
Represents a collection of RectModifier animations. 



Represents a collection of ShortModifier animations. 



Defines an animation based on the Size of an object. By providing Size information, 
an object can appear to shrink or enlarge over a period of time. 
Represents a collection of SizeModifier animations. 



Represents a collection of StringModifier animations. 



Maintains run-time timing state for timed objects. 

An object that can be used to create Timeline objects. 

The object that controls an entire timing tree. 

An object that performs type conversions involving TimeSyncValue values. 
An object that performs type conversions involving Time values. 
Used to animate properties that accept a Vector value. 
Represents a collection of VectorModifier animations. 
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VectorKeyFrameCollection 

VectorModifier 

VectorTimedModifier 

Interfaces 

ICIock 

(Modifier 

ITimingControl 
ITimingControlBuilder 

Enumerations 

AnimationType 
CloneType 
InterpolationMethod 
KeyTimeType 

TimeEndSync 

TimeFill 
TimeRestart 

TimeSeekOrigin 

TimeSyncBase 

Structures 

ColorKeyFrame 

DoubleKeyFrame 

FloatKeyFrame 

KeySpline 

KeyTime 

LengthKeyFrame 

PointKeyFrame 

RectKeyFrame 

SizeKeyFrame 

Time 

TimelineEnumerator 

TimeSyncValue 

VectorKeyFrame 



Represents an object that can provide linear time values. 

Defines the basic behavior of a modifier object. A modifier is an object that takes an 
object, called the base value, of a certain type and returns another object of the 
same type as its output. 

Defines the behavior of timelines and timed objects. 
Represents an object that can build a timeline template. 



Describes the behavior of an animation. 
The types of clones that CloneCore may request. 
Describes how an animation calculates its output values. 
The different types of KeyTimes 

Values for the endSync attribute, which specifies how a container calculates its 
simple duration based on the children's durations. 

Specifies how the timeline behaves after it is no longer active. 

Values for the Timeline. Restart attribute. 

Indicates a timeline position; used to specify the behavior of the ITimingControl 
interface's Seek method by defining the position to which the offset is applied. 
The event to synchronize a begin or end value to. 



This class is used to pass an array of key splines into the KeySplines property of an 
animation fragment. 

A KeyTime is use to specify when relative to the time of an animation that a 
KeyFrame takes place. 



A value representing time, with associated time arithmetic operations. 
Enumerates items in an TimelineList collection. 

A value representing an absolute or relative begin or end time for a timeline. 
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MSAvalon.Windows.Media.Animation 



CLASSES 



Animatable Class 

Definition: Any class that doesn't derive from DependencyObject but which has properties that can be 
animated should derive from this class. 



Method 



Animatable 
CloneCore 
CloneCore 

CloneDownToUnchangeable 

Copy 
DisableCore 

EmbeddedAnimationCollectionReader Maybe this should be internal?? 

EmbeddedAnimationCollectionWriter 

EmbeddedChangeableReader 

EmbeddedChangeableWriter 

EnableCore 



Description 

Returns a modifiable shallow or deep clone of the current object. 
This abstract method must be implemented by classes that 
derive from Changeable. Inherited from Changeable. 

Subclasses must implement this to provide clones of themselves. 

Returns an immutable copy of the specified object. Inherited from 
Changeable. 

Returns a modifiable copy of the current object. The copy's 
IsChangeable property is true and its StatusOfNextUse is 
Unchangeable. Inherited from Changeable. 



Equals 
Finalize 

GetCurrentValue 

GetHashCode 
GetType 

MakeUnchangeable 

MakeUnchangeableCore 
MemberwiseClone 

ModifyHandlerlfChangeable 
OnChanged 



Determines whether two Object instances are equal. Inherited 
from Object. 

Allows an Object to attempt to free resources and perform other 
cleanup operations before the Object is reclaimed by garbage 
collection. Inherited from Object. 

Returns a non-animated version of this Animatable that 
represents its current state. 

Serves as a hash function for a particular type, suitable for use in 
hashing algorithms and data structures like a hash 
table. Inherited from Object. 

Gets the Type of the current instance. Inherited from Object. 
Makes an object immutable; after this method is called on a 
Changeable, its IsChangeable property is false. Inherited from 
Changeable. 

Makes a Changeable object immutable, inherited from 
Changeable. 

Creates a shallow copy of the current Object. Inherited from 
Object. 

Adds or removes a Changed event handler to or from the 
specified Changeable object, if the object is currently modifiable. 
If the specified object is not modifiable — if its IsChangeable 
property is false — this method has no effect. Inherited from 
Changeable. 

Called when the current object is modified. Classes that derive 
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PropagateEventHandler 
ReadPreamble 

ReferenceEquals 

SetDefaultParentTimeline 

SetDefaultParentTimelineCore 
ToString 

ValidateObjectState 
WritePostscript 

WritePreamble 



from Changed should call this method after they have been 
modified. Inherited from Changeable. 

Shares a Changed event handler with the current object's data 
members or removes it. Inherited from Changeable. 

Ensures that simple (non-Changeable) members are being 
accessed from a valid Ul context. This method should be called 
before any simple members are accessed. Inherited from 
Changeable. 

Determines whether the specified Object instances are the same 
instance. Inherited from Object. 

This will change the time parent for animations on any of the 
properties of this Changeable which are inheriting their time 
parent. 

Returns a String that represents the current Object. Inherited 
from Object. 

Verifies that the current object has a valid state. If the object is in 
an invalid state, this method throws an exception. Inherited from 
Changeable. 

Causes the current object to validate itself and then invokes the 
OnChanged method. Inherited from Changeable. 

Ensures that simple (non-Changeable) members are being 
accessed from a valid user interface (Ul) context. This method 
should be called before any simple members are set. Inherited 
from Changeable. 



Property Description 

Used in conjunction with the ChangeableUsageOverride type sent in 

AllowChangeableReferenceOverride * s * P arame t er t0 ChangeableHelper.UseChangeable, to help 
9 determine when a Changeable being put into "use" should be 

promoted to "ChangeableReference". Inherited from Changeable. 

True if this Changeable can be made unchangeable. Inherited from 
Changeable. 

The current parent Timeline associated with this Animatable. This 
will be the Timeline set to the ParentTimeline property of this 
Animatable if one has been set and if not, the Timeline last passed 
into the SetDefaultParentTimeline method. 



CanMakeUnchangeable 

DefaultParentTimeline 

HasAnimations 

IsAnimating 

IsChangeable 

I sOverrid ing Base Value 
StatusOfNextUse 



Returns true if any of the properties on this Changeable have 
animations attached. 

Returns true if any of the properties on this Changeable have 
animations attached that are currently animating their value. 

Gets a Boolean that indicates whether the object is currently 
modifiable. Inherited from Changeable. 

Returns true if any of the properties on this Changeable have 
animations attached that are currently affecting their value either by 
animating it or holding it in a fill state. 

Gets or sets a UseStatus enumeration that specifies how the 
Changeable object behaves when it is "used." A Changeable object 
is considered used in the following situations: the object is set into a 
Property System property, the object is used as a sub-object in a 
complex Changeable object, or the object is used in a 
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UlContext 



DrawingContext command. Inherited from Changeable. 

Gets the UlContext of the current object. The UlContext is used for 
maintaining thread safety. Inherited from Changeable. 



AnimationCollection Class 

Definition: This abstract class provides base functionality for animation collections, such as 
ColorAnimationCollection, DoubleAnimationCollection, and SizeAnimationCollection. 



Method 

AnimationCollection 

CloneCore 

CloneDownToUnchangeable 



Description 

Returns a modifiable shallow or deep clone of the current object. This 
abstract method must be implemented by classes that derive from 
Changeable. Inherited from Changeable. 

Returns an immutable copy of the specified object. Inherited from 
Changeable. 

Returns a modifiable copy of the current object. The copy's 
IsChangeable property is true and its StatusOfNextUse is 
Unchangeable. Inherited from Changeable. 



Copy 

Disable 
Disablelmpl 

Accesses the specified Changeable data member, processes it, and 
returns a reference to the member. This reference should then be 
EmbeddedChangeableReader reassigned to the original member variable. Classes that derive from 

Changeable call this method on data members before they can be 
retrieved through property calls. Inherited from Changeable. 

Processes a modified Changeable data member and returns a reference 
to the processed object. Inherited from Changeable. 



EmbeddedChangeableWriter 

Enable 
Enablelmpl 

Equals 
Finalize 

GetEnumerator 
GetEnumeratorlmpI 

GetHashCode 

GetType 

GetValue 

GetValuelmpI 

MakeUnchangeable 

MakeUnchangeableCore 

MemberwiseClone 

ModifyHandlerlfChangeable 



Determines whether two Object instances are equal. Inherited from 
Object. 

Allows an Object to attempt to free resources and perform other cleanup 
operations before the Object is reclaimed by garbage 
collection. Inherited from Object. 

GetEnumerator 

Serves as a hash function for a particular type, suitable for use in 
hashing algorithms and data structures like a hash table. Inherited from 
Object. 

Gets the Type of the current instance. Inherited from Object. 

Calculates and returns the output value of the animation collection. 

Subclasses implement this to provide a Modifier at a given index. 

Makes an object immutable; after this method is called on a 
Changeable, its IsChangeable property is false. Inherited from 
Changeable. 

Makes a Changeable object immutable. Inherited from Changeable. 
Creates a shallow copy of the current Object. Inherited from Object. 
Adds or removes a Changed event handler to or from the specified 
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OnChanged 

PropagateEventHandler 
ReadPreamble 

ReferenceEquals 

SetDefaultParentTimeline 
SetValuelmpI 

ToString 

ValidateObjectState 
WritePostscript 

WritePreamble 



Changeable object, if the object is currently modifiable. If the specified 
object is not modifiable— if its IsChangeable property is false— this 
method has no effect. Inherited from Changeable. 

Called when the current object is modified. Classes that derive from 
Changed should call this method after they have been 
modified. Inherited from Changeable. 

Shares a Changed event handler with the current object's data members 
or removes it. Inherited from Changeable. 

Ensures that simple (non-Changeable) members are being accessed 
from a valid Ul context. This method should be called before any simple 
members are accessed. Inherited from Changeable. 

Determines whether the specified Object instances are the same 
instance. Inherited from Object. 

Subclasses implement this to set a Modifier at a given index. 

Returns a String that represents the current Object. Inherited from 
Object. 

Verifies that the current object has a valid state. If the object is in an 
invalid state, this method throws an exception. Inherited from 
Changeable. 

Causes the current object to validate itself and then invokes the 
OnChanged method. Inherited from Changeable. 

Ensures that simple (non-Changeable) members are being accessed 
from a valid user interface (Ul) context. This method should be called 
before any simple members are set. Inherited from Changeable. 



Property 



Description 

Used in conjunction with the ChangeableUsageOverride type sent in 

AllowChangeableReferenceOverride as a P arame * er t0 ChangeableHelper.UseChangeable, to help 

determine when a Changeable being put into "use" should be 
promoted to "ChangeableReference". Inherited from Changeable. 
AnimationType 

True if this Changeable can be made unchangeable. Inherited from 
Changeable. 



AnimationType 

CanMakeUnchangeable 

Count 
Countlmpl 

IsChangeable 
IsChanging 

IsOverridingBaseValue 

IsUsingBaseVaiue 

IsUsingBaseValuelmpI 

Item 

StatusOfNextUse 



Gets a Boolean that indicates whether the object is currently 
modifiable. Inherited from Changeable. 

Returns true if at least one of the animations in the animation list is 
currently active. 

Returns true if at least one of the animations in the animation list is 
currently on. 



Use this to get or set a Modifier at a given index. 
Gets or sets a UseStatus enumeration that specifies how the 
Changeable object behaves when it is "used." A Changeable object 
is considered used in the following situations: the object is set into a 
Property System property, the object is used as a sub-object in a 
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complex Changeable object, or the object is used in a 
DrawingContext command. Inherited from Changeable. 

UlContext Gets the u| Context of the current object. The UlContext is used for 

maintaining thread safety. Inherited from Changeable. 

The AnimationCollection classes provide you with more control over how you animate a property than a 
single animation could. Each of the AnimationCollection classes effectively functions as a single 
composite animation, using all the animations in the collection to animate a base value. When a property 
requests the current value of an AnimationCollection, the property calls the AnimationCollection's 
GetValue method and passes it the property's base value. The first animation in the collection processes 
this base value and produces a result, which is then passed to the next animation in the collection, and so 
on, until the value has been processed by all the animations in the collection. 

This example demonstrates how to animate a property using "Longhorn" markup language (code-named 
"XAML"). To animate a property, you associate the proper animation collection and animations with the 
property either directly or using the property's corresponding animation property. There are a variety of 
animation classes, each of which animates a different kind of value. 

Before some properties can be animated, they must be given a base value. For example, before 
animating the RectangleWidth of a Rectangle, the RectangleWidth must be set to a non-animated value 
(in this case, a Length object). 

In the following example, the Width of a Button is animated. Because the Width property takes a Length, 
a LengthAnimation is needed. A LengthAnimationCollection is used to contain the LengthAnimation. 
Although in this example there is only one animation, you could associate multiple animations with a 
single property by placing the animations within the collection. Because there is no WidthAnimations 
property, the LengthAnimationCollection is associated directly with the button's Width property. 

<Canvas ID="root" 

xmlns="http://schemas.microsoft.com/2003/xaml"> 

<Button Canvas.Top="20" Canvas. Left="20" 
Height= M 30" Width="200"> 

<Button.Width> 
<LengthAnimationCollection> 
<LengthAnimation To="50" Duration="5" RepeatCount="500" 
AutoReverse="True"/> 
</LengthAnimationCollection> 
</Button.Width> 

A Button 
</Button> 

In the next example, the Background color of a second button is animated. The Background property 
takes a Brush. In this example, a SolidColorBrush is used to fill the button's Background, although a 
gradient, image, or pattern could have been used. To animate the button's background color, the Color of 
the SolidColorBrush must be animated. Because the SolidColorBrush.Color property accepts a Color, a 
ColorAnimation is used to animate the property. The SolidColorBrush.Color property has a corresponding 
ColorAnimations property, so the ColorAnimation is nested within the ColorAnimations property in order 
to animate the color of the brush. 

<Button Canvas.Top="70" Canvas. Left="20" 
Height="30" Width="200"> 
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<Button. Background 
<SolidColorBrush Color^'Blue'^ 
<SolidColorBrush.ColorAnimations> 
<ColorAn inflation From="RecT To="Blue" Duration= ,, 7" 
RepeatCount="500" AutoReverse="True'Y> 
</SolidColorBmsh.ColorAnimations> 
</SolidColorBrush> 
</B u tto n . Backg rou nd > 

Another Button 
</Button> 

</Canvas> 

In the previous example, the ColorAnimationCollection tag, <ColorAnimationCollection> is omitted when 
animating the brush's color. When animating a designated animation property— properties of the form 
PropertyNameAnimations, such as the ColorAnimations property in the previous example— you may omit 
the animation collection tag. However, when animating a property of a Ul element— those classes that 
derive from UlElement— you must nest the animations within an animation collection tag. 
For more information about animating properties, see Animation in "Avalon". 



Animation Effect Class 

Definition: Override this class to implement element level animations which can participate in the 
rendering process to instantiate animations on multiple elements at rendering time. 



Method 

AnimationEffect 



Attachlmpl 



CloneCore 

CloneDownToUnchangeable 
Copy 

Detach I mpl 

EmbeddedChangeableReader 

EmbeddedChangeableWriter 
Equals 



Description 

Default constructor of an AnimationEffect. 

Override this method if you would like to store per Element instance 
data for this AnimationEffect. Keep in mind that when this is called the 
element might not be in an element tree or its children may not have 
been added. If these things are important to you, you should override 
this method and sign up for the event notifications that are important to 
you and update the state of the animation effect when those events are 
raised. 

Returns a modifiable shallow or deep clone of the current object. This 
abstract method must be implemented by classes that derive from 
Changeable. Inherited from Changeable. 

Returns an immutable copy of the specified object. Inherited from 
Changeable. 

Returns a modifiable copy of the current object. The copy's 
IsChangeable property is true and its StatusOfNextUse is 
Unchangeable. Inherited from Changeable. 

Override this method if you need to do some cleanup when this 

AnimationEffect is detached from an Element. 

Accesses the specified Changeable data member, processes it, and 

returns a reference to the member. This reference should then be 

reassigned to the original member variable. Classes that derive from 

Changeable call this method on data members before they can be 

retrieved through property calls. Inherited from Changeable. 

Processes a modified Changeable data member and returns a reference 

to the processed object. Inherited from Changeable. 

Determines whether two Object instances are equal. Inherited from 
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Finalize 

GetHashCode 
GetType 

Invalidate 



InvalidatePassive 



MakeUnchangeable 

MakeUnchangeableCore 
MemberwiseClone 

ModifyHandlerlfChangeable 



OnChanged 

PostLayoutReadlmpI 

PreLayoutReadlmpI 

PreLayoutWritelmpI 

PropagateEventHandler 

ReadPreamble 

ReferenceEquals 
ToString 

ValidateObjectState 



Object. 

Allows an Object to attempt to free resources and perform other cleanup 
operations before the Object is reclaimed by garbage 
collection. Inherited from Object. 

Serves as a hash function for a particular type, suitable for use in 
hashing algorithms and data structures like a hash table. Inherited from 
Object. 

Gets the Type of the current instance. Inherited from Object. 
Calling this method will place this AnimationEffect in the list of animation 
effects to be processed during the next render. After calling this, the 
Islnvalid property will return true until the beginning of the next render. If 
no render is currently scheduled calling this method will schedule a 
render. 

Calling this method will place this AnimationEffect in the list of animation 
effects to be processed during the next render. After calling this, the 
Islnvalid property will return true until the beginning of the next render. If 
no render is scheduled, calling this method will not schedule a new 
render. Something else will have to trigger a render. 
Makes an object immutable; after this method is called on a 
Changeable, its IsChangeable property is false. Inherited from 
Changeable. 

Makes a Changeable object immutable. Inherited from Changeable. 
Creates a shallow copy of the current Object. Inherited from Object. 
Adds or removes a Changed event handler to or from the specified 
Changeable object, if the object is currently modifiable. If the specified 
object is not modifiable— if its IsChangeable property is false— this 
method has no effect. Inherited from Changeable. 
Called when the current object is modified. Classes that derive from 
Changed should call this method after they have been 
modified. Inherited from Changeable. 

This method will be called once per render pass. This method can be 

used to read the final values from the element tree after rendering. The 

element tree will be locked when this method is called. 

This method will be called one or more times when the rendering 

process begins. The element tree will be locked when this method is 

called. 

This method will be called one or more times when the rendering 
process begins and after OnPreLayoutRead. The element tree will be 
unlocked no so this is the time to add animations or new elements. Tip: 
It's best to do as little reading from the element tree as possible in this 
method. Do all the reading you can in the OnPreLayoutRead method. 
Shares a Changed event handler with the current object's data 
members or removes it. Inherited from Changeable. 
Ensures that simple (non-Changeable) members are being accessed 
from a valid Ul context. This method should be called before any simple 
members are accessed. Inherited from Changeable. 

Determines whether the specified Object instances are the same 
instance. Inherited from Object. 

Returns a String that represents the current Object. Inherited from 
Object. 

Verifies that the current object has a valid state. If the object is in an 
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WritePostscript 
WritePreamble 



invalid state, this method throws an exception. Inherited from 
Changeable. 

Causes the current object to validate itself and then invokes the 
OnChanged method. Inherited from Changeable. 

Ensures that simple (non-Changeable) members are being accessed 
from a valid user interface (Ul) context. This method should be called 
before any simple members are set. Inherited from Changeable. 



CanMakeUnchangeable 
IsChangeable 



Property Description 

Used in conjunction with the ChangeableUsageOverride type sent in 

AllowChangeableReferenceOverride ^ P arame t ert0 ChangeableHelper.UseChangeable, to help 

determine when a Changeable being put into "use" should be 
promoted to "ChangeableReference". Inherited from Changeable. 

True if this Changeable can be made unchangeable. Inherited from 
Changeable. 

Gets a Boolean that indicates whether the object is currently 
modifiable. Inherited from Changeable. 

Returns true if this AnimationEffect is in the list of AnimationEffects 
to be processed during the next render. 

Gets or sets a UseStatus enumeration that specifies how the 
Changeable object behaves when it is "used." A Changeable object 
is considered used in the following situations: the object is set into a 
Property System property, the object is used as a sub-object in a 
complex Changeable object, or the object is used in a 
DrawingContext command. Inherited from Changeable. 
The element that this AnimationEffect is attached to or null if the 
AnimationEffect is not attached to an element. 

Gets the UlContext of the current object. The UlContext is used for 
maintaining thread safety. Inherited from Changeable. 



Islnvalid 



StatusOfNextUse 



Target 



UlContext 



AnimationEffectCollection Class 

Definition: Holds a collection of AnimationEffects. 



Method 

Add 

AnimationEffectCollection 
Clear 

CloneCore 

CloneDownToUnchangeable 

Contains 
Copy 



Description 

Creates an empty AnimationEffectCollection with a default capacity for a 
single animation. 

CloneCore 

Returns an immutable copy of the specified object. Inherited from 
Changeable. 



Copy Returns a modifiable copy of the current object. The copy's 

IsChangeable property is true and its StatusOfNextUse is 
Unchangeable. Inherited from Changeable. 

CopyTo 

EmbeddedChangeableReader Accesses the specified Changeable data member, processes it, and 
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EmbeddedChangeableWriter 
Equals 

Finalize 

GetEnumerator 

GetHashCode 

GetType 
IndexOf 
Insert 

MakeUnchangeable 

MakeUnchangeableCore 
MemberwiseClone 

ModifyHandlerlfChangeable 

OnChanged 
opjmplicit 

PropagateEventHandler 
Read Preamble 

ReferenceEquals 

Remove 
RemoveAt 

ToString 

ValidateObjectState 
WritePostscript 

WritePreamble 



returns a reference to the member. This reference should then be 
reassigned to the original member variable. Classes that derive from 
Changeable call this method on data members before they can be 
retrieved through property calls. Inherited from Changeable. 

Processes a modified Changeable data member and returns a 
reference to the processed object. Inherited from Changeable. 

Determines whether two Object instances are equal. Inherited from 
Object. 

Allows an Object to attempt to free resources and perform other cleanup 
operations before the Object is reclaimed by garbage 
collection. Inherited from Object. 

Returns an object that can be used to enumerate items in the list. 
Serves as a hash function for a particular type, suitable for use in 
hashing algorithms and data structures like a hash table. Inherited from 
Object. 

Gets the Type of the current instance. Inherited from Object. 



Makes an object immutable; after this method is called on a 
Changeable, its IsChangeable property is false. Inherited from 
Changeable. 

Implementation of MakeUnchangeableCore. 
Creates a shallow copy of the current Object. Inherited from Object. 
Adds or removes a Changed event handler to or from the specified 
Changeable object, if the object is currently modifiable. If the specified 
object is not modifiable — if its IsChangeable property is false — this 
method has no effect. Inherited from Changeable. 

OnChanged 

Implementation of PropagateEventHandler. 

Ensures that simple (non-Changeable) members are being accessed 
from a valid Ul context. This method should be called before any simple 
members are accessed. Inherited from Changeable. 

Determines whether the specified Object instances are the same 
instance. Inherited from Object. 



Returns a String that represents the current Object. Inherited from 
Object. 

Verifies that the current object has a valid state. If the object is in an 
invalid state, this method throws an exception. Inherited from 
Changeable. 

Causes the current object to validate itself and then invokes the 
OnChanged method. Inherited from Changeable. 

Ensures that simple (non-Changeable) members are being accessed 
from a valid user interface (Ul) context. This method should be called 
before any simple members are set. Inherited from Changeable. 



Pr perty 



Description 
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AllowChangeableReferenceOverride 

CanMakeUnchangeable 
Empty 

IsChangeable 

IsFixedSize 
IsReadOnly 
IsSynchronized 
Item 

StatusOfNextUse 

SyncRoot 
UlContext 



Used in conjunction with the ChangeableUsageOverride type sent 
in as a parameter to ChangeableHelper.UseChangeable, to help 
determine when a Changeable being put into "use" should be 
promoted to "ChangeableReference". Inherited from Changeable. 

True if this Changeable can be made unchangeable. Inherited 
from Changeable. 

An unchangeable empty AnimationEffectCollection. 

Gets a Boolean that indicates whether the object is currently 
modifiable. Inherited from Changeable. 



this - typed version of indexer 

Gets or sets a UseStatus enumeration that specifies how the 
Changeable object behaves when it is "used." A Changeable 
object is considered used in the following situations: the object is 
set into a Property System property, the object is used as a sub- 
object in a complex Changeable object, or the object is used in a 
DrawingContext command. Inherited from Changeable. 

Gets the UlContext of the current object. The UlContext is used for 
maintaining thread safety. Inherited from Changeable. 



BoolAnimationCollection Class 

Definition: Represents a collection of BoolModifier animations. 



Method 

Add 

AddChild 
AddText 
Apply 

BoolAnimationCollection 

Clear 
CloneCore 

CloneDownToUnchangeable 

Contains 

Copy 
Copy 



Description 

The Add(BoolModifier) and Add(Object) methods add animations to the 
collection. The Add(Boolean, BoolAnimationCollection) method 
calculates the current value of the specified collection based on the 
specified base value. 

Implementation of AddChild. Adds a Modifier to this AnimationCollection 
from Markup. 

Implementation of AddText. This is not implemented on this class. 

Implementation of Apply. Applies an animation collection in markup to 
an element. 

Creates an empty BoolAnimationCollection with a default capacity for a 
single animation. 

Clears the collection by setting the collection's Count to 0. 
CloneCore 

Returns an immutable copy of the specified object. Inherited from 
Changeable. 

Returns a Boolean that indicates whether the collection contains the 
specified BoolModifier. 

Returns a modifiable copy of the current object. The copy's 
IsChangeable property is true and its StatusOfNextUse is 
Unchangeable. Inherited from Changeable. 

Creates a copy of this BoolAnimationCollection. 
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CopyTo 

Disable 
Disablelmpl 



Copies the entire BoolAnimationCollection to the specified one- 
dimensional array, starting at the specified index of the target array. 
Inherited from AnimationCollection. 



Accesses the specified Changeable data member, processes it, and 
returns a reference to the member. This reference should then be 
EmbeddedChangeableReader reassigned to the original member variable. Classes that derive from 

Changeable call this method on data members before they can be 
retrieved through property calls. Inherited from Changeable. 

Processes a modified Changeable data member and returns a reference 
to the processed object. Inherited from Changeable. 

Inherited from AnimationCollection. 



EmbeddedChangeableWriter 

Enable 
Enablelmpl 

Equals 
Finalize 

GetEnumerator 
GetEnumeratorlmpI 

GetHashCode 

GetType 

GetValue 

GetValuelmpI 

IndexOf 

Insert 

MakeUnchangeable 

MakeUnchangeableCore 
MemberwiseClone 

ModifyHandlerlfChangeable 

OnChanged 
op_Addition 
opjmplicit 

PropagateEventHandler 
ReadPreamble 

ReferenceEquals 
Remove 



Determines whether two Object instances are equal. Inherited from 
Object. 

Allows an Object to attempt to free resources and perform other cleanup 
operations before the Object is reclaimed by garbage 
collection. Inherited from Object. 

GetEnumerator Inherited from AnimationCollection. 

Returns an object that can be used to enumerate items in the list. 

Serves as a hash function for a particular type, suitable for use in 

hashing algorithms and data structures like a hash table. Inherited from 

Object. 

Gets the Type of the current instance. Inherited from Object. 

Uses the specified base value to calculate and return the animation 
collection's current value. 

Provides a Modifier at a given index. 



Makes an object immutable; after this method is called on a 
Changeable, its IsChangeable property is false. Inherited from 
Changeable. 

Implementation of MakeUnchangeableCore. 

Creates a shallow copy of the current Object. Inherited from Object. 

Adds or removes a Changed event handler to or from the specified 

Changeable object, if the object is currently modifiable. If the specified 

object is not modifiable— if its IsChangeable property is false — this 

method has no effect. Inherited from Changeable. 

OnChanged 



Implementation of PropagateEventHandler. 

Ensures that simple (non-Changeable) members are being accessed 
from a valid Ul context. This method should be called before any simple 
members are accessed. Inherited from Changeable. 

Determines whether the specified Object instances are the same 
instance. Inherited from Object. 
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RemoveAt 

SetDefaultParentTimeline 
SetValuelmpI 

ToString 

ValidateObjectState 
WritePostscript 

WritePreamble 



Inherited from AnimationCollection. 
Sets a Modifier at a given index. 

Returns a String that represents the current Object. Inherited from 
Object. 

Verifies that the current object has a valid state. If the object is in an 
invalid state, this method throws an exception. Inherited from 
Changeable. 

Causes the current object to validate itself and then invokes the 
OnChanged method. Inherited from Changeable. 

Ensures that simple (non-Changeable) members are being accessed 
from a valid user interface (Ul) context. This method should be called 
before any simple members are set. Inherited from Changeable. 



Property 

AllowChangeableReferenceOverride 

AnimationType 

CanMakeUnchangeable 

Count 

Countlmpl 

Empty 

IsChangeable 

IsChanging 

IsFixedSize 

IsOverridingBaseValue 

IsReadOnly 

IsSynchronized 

IsUsingBaseValue 

IsUsingBaseValuelmpI 

Item 

Item 



StatusOfNextUse 

SyncRoot 
UlContext 



Description 

Used in conjunction with the ChangeableUsageOverride type sent 
in as a parameter to ChangeableHelper.UseChangeable, to help 
determine when a Changeable being put into "use" should be 
promoted to "ChangeableReference". Inherited from Changeable. 
AnimationType 

True if this Changeable can be made unchangeable. Inherited 
from Changeable. 

Inherited from AnimationCollection. 

An unchangeable empty BoolAnimationCollection. 

Gets a Boolean that indicates whether the object is currently 

modifiable. Inherited from Changeable. 

Returns true if at least one of the animations in the animation list is 
currently active. Inherited from AnimationCollection. 

Returns true if at least one of the animations in the animation list is 
currently on. Inherited from AnimationCollection. 



Inherited from AnimationCollection. 
this - typed version of indexer 

Use this to get or set a Modifier at a given index. Inherited from 
AnimationCollection. 

Gets or sets a UseStatus enumeration that specifies how the 
Changeable object behaves when it is "used." A Changeable 
object is considered used in the following situations: the object is 
set into a Property System property, the object is used as a sub- 
object in a complex Changeable object, or the object is used in a 
DrawingContext command. Inherited from Changeable. 

Gets the UlContext of the current object. The UlContext is used for 
maintaining thread safety. Inherited from Changeable. 
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The AnimationCollection classes, such as BoolAnimationCollection, provide you with more control over 
how you animate a property than a single animation could. Each of the AnimationCollection classes 
effectively functions as a single composite animation, using all the animations in the collection to animate 
a base value. When a property requests the current value of an BoolAnimationCollection the property 
calls the BoolAnimationCollection's GetValue method and passes it the property's base value. The first 
animation in the collection processes this base value and produces a result, which is then passed to the 
next animation in the collection, and so on, until the value has been processed by all the animations in the 
collection. 

This example demonstrates how to animate a property using "Longhorn" markup language (code-named 
"XAML"). To animate a property, you associate the proper animation collection and animations with the 
property either directly or using the property's corresponding animation property. There are a variety of 
animation classes, each of which animates a different kind of value. 

Before some properties can be animated, they must be given a base value. For example before 
animating the RectangleWidth of a Rectangle, the RectangleWidth must be set to a non-animated value 
(in this case, a Length object). 

In the following example, the Width of a Button is animated. Because the Width property takes a Length 
a LengthAnimation is needed. A LengthAnimationCollection is used to contain the LengthAnimation. 
Although in this example there is only one animation, you could associate multiple animations with a 
single property by placing the animations within the collection. Because there is no WidthAnimations 
property, the LengthAnimationCollection is associated directly with the button's Width property. 

<Canvas ID="root" 
xmlns="http://schemas.microsoft.com/2003/xamr , > 

<Button Canvas.Top= ,, 20" Canvas. Left="20" 
Height= n 30 M Width="200"> 

<Button.Width> 
<LengthAnimationCollection> 

<LengthAnimation To="50" Duration="5" RepeatCount="500" 
AutoReverse="True7> 
</LengthAnimationCollection> 
</Button.Width> 

A Button 
</Button> 

In the next example, the Background color of a second button is animated. The Background property 
takes a Brush. In this example, a SolidColorBrush is used to fill the button's Background, although a 
gradient, image, or pattern could have been used. To animate the button's background color the Color of 
the SolidColorBrush must be animated. Because the SolidColorBrush.Color property accepts a Color a 
ColorAnimation is used to animate the property. The SolidColorBrush.Color property has a corresponding 
ColorAnimations property, so the ColorAnimation is nested within the ColorAnimations property in order 
to animate the color of the brush. 

<Button Canvas.Top="70" Canvas. Left- '20" 
Height="30" Width="200"> 

<Button.Background> 
<SolidColorBrush Color= M Blue H > 
<SolidColorBrush.ColorAnimations> 
<ColorAnimation From="Red" To="Blue n Duration^?" 
RepeatCou nt="500" AutoRe verse="True7> 
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</SolidColorBrush.ColorAnimations> 
</SolidColorBrush> 
</Button . Background> 

Another Button 
</Button> 

</Canvas> 

In the previous example, the ColorAnimationCollection tag, <ColorAnimationCollection> is omitted when 
animating the brush's color. When animating a designated animation property— properties of the form 
PropertyNameAnimations, such as the ColorAnimations property in the previous example— you may omit 
the animation collection tag. However, when animating a property of a Ul element— those classes that 
derive from UlElement— you must nest the animations within an animation collection tag. 
For more information about animating properties, see Animation in "Avalon". 



BoolModifier Class 



Method 

BoolModifier 

CloneCore 



CloneDownToUnchangeable 

Copy 

Copy 

EmbeddedChangeableReader 

EmbeddedChangeableWriter 
Equals 

Finalize 

GetHashCode 

GetType 

GetValue 

GetValuelmpI 

IModifier.GetValue 

MakeUnchangeable 



Description 

Returns a modifiable shallow or deep clone of the current object. This 
abstract method must be implemented by classes that derive from 
Changeable. Inherited from Changeable. 

Returns an immutable copy of the specified object. Inherited from 
Changeable. 

Returns a modifiable copy of the current object. The copy's 
IsChangeable property is true and its StatusOfNextUse is 
Unchangeable. Inherited from Changeable. 
Creates a copy of this BoolModifier 

Accesses the specified Changeable data member, processes it, and 
returns a reference to the member. This reference should then be 
reassigned to the original member variable. Classes that derive from 
Changeable call this method on data members before they can be 
retrieved through property calls. Inherited from Changeable. 
Processes a modified Changeable data member and returns a 
reference to the processed object. Inherited from Changeable. 

Determines whether two Object instances are equal. Inherited from 
Object. 

Allows an Object to attempt to free resources and perform other cleanup 
operations before the Object is reclaimed by garbage 
collection. Inherited from Object. 

Serves as a hash function for a particular type, suitable for use in 
hashing algorithms and data structures like a hash table. Inherited from 
Object. 

Gets the Type of the current instance. Inherited from Object. 



Inherited from Modifier. 

Makes an object immutable; after this method is called on a 
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MakeUnchangeableCore 
MemberwiseClone 

ModifyHandlerlfChangeable 

OnChanged 
opjmplicit 

PropagateEventHandler 

ReadPreamble 

ReferenceEquals 

SetDefaultParentTimeline 

ToString 

ValidateObjectState 
WritePostscript 

WritePreamble 



Changeable, its IsChangeable property is false. Inherited from 
Changeable. 

MakeUnchangeableCore Inherited from Modifier. 
Creates a shallow copy of the current Object. Inherited from Object. 
Adds or removes a Changed event handler to or from the specified 
Changeable object, if the object is currently modifiable. If the specified 
object is not modifiable— if its IsChangeable property is false— this 
method has no effect. Inherited from Changeable. 

Called when the current object is modified. Classes that derive from 
Changed should call this method after they have been 
modified. Inherited from Changeable. 

Implicitly creates an AnimationCollection from a BoolModifier 
Shares a Changed event handler with the current object's data 
members or removes it. Inherited from Changeable. 
Ensures that simple (non-Changeable) members are being accessed 
from a valid Ul context. This method should be called before any simple 
members are accessed. Inherited from Changeable. 

Determines whether the specified Object instances are the same 
instance. Inherited from Object. 

SetDefaultParentTimeline Inherited from Modifier. 

Returns a String that represents the current Object. Inherited from 
Object. 

Verifies that the current object has a valid state. If the object is in an 
invalid state, this method throws an exception. Inherited from 
Changeable. 

Causes the current object to validate itself and then invokes the 
OnChanged method. Inherited from Changeable. 

Ensures that simple (non-Changeable) members are being accessed 
from a valid user interface (Ul) context. This method should be called 
before any simple members are set. Inherited from Changeable. 



Property 

AllowChangeableReferenceOverride 

CanMakeUnchangeable 

IsChangeable 

IsChanging 

IsOverridingBaseValue 
StatusOfNextUse 



Description 

Used in conjunction with the ChangeableUsageOverride type sent 
in as a parameter to ChangeableHelper.UseChangeable, to help 
determine when a Changeable being put into "use" should be 
promoted to "ChangeableReference". Inherited from Changeable. 

True if this Changeable can be made unchangeable. Inherited 
from Changeable. 

Gets a Boolean that indicates whether the object is currently 
modifiable. Inherited from Changeable. 

Gets a value that indicates whether the animation is 
active. Inherited from Modifier. 

Gets a value that indicates whether the animation is active or in a 
fill period. Inherited from Modifier. 

Gets or sets a UseStatus enumeration that specifies how the 
Changeable object behaves when it is "used." A Changeable 
object is considered used in the following situations: the object is 
set into a Property System property, the object is used as a sub- 
object in a complex Changeable object, or the object is used in a 
DrawingContext command. Inherited from Changeable. 
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UlContext 
UsesBaseValue 



Gets the UlContext of the current object. The UlContext is used for 
maintaining thread safety. Inherited from Changeable. 

UsesBaseValue Inherited from Modifier. 



BoolTimedModifier Class 
Method 

Beginln 

BoolTimedModifier 



Description 

Starts or restarts the animation at the specified offset from the current 
time. 



Returns a modifiable shallow or deep clone of the current object. This 
abstract method must be implemented by classes that derive from 
Changeable. Inherited from Changeable. 

Returns an immutable copy of the specified object. Inherited from 
Changeable. 

Creates a copy of this BoolTimedModifier 

Returns a modifiable copy of the current object. The copy's 
IsChangeable property is true and its StatusOfNextUse is 
Unchangeable. Inherited from Changeable. 

Creates a copy of this BoolModifier Inherited from BoolModifier. 
Disables this timeline, after which the timeline can no longer become 
active. The timeline can be re-enabled with a call to Enable. 
Accesses the specified Changeable data member, processes it, and 
returns a reference to the member. This reference should then be 
EmbeddedChangeableReader reassigned to the original member variable. Classes that derive from 

Changeable call this method on data members before they can be 
retrieved through property calls. Inherited from Changeable. 
Processes a modified Changeable data member and returns a 
reference to the processed object. Inherited from Changeable. 
Enables this timeline, parenting it to the timeline specified by the 
ParentTimeline property. This allows the timeline to become active. 
This method throws an exception if the ParentTimeline property is null. 
Schedules an interactive end time. 



CloneCore 

CloneDownToUnchangeable 
Copy 

Copy 

Copy 
Disable 



EmbeddedChangeableWriter 



Enable 



Endln 
Equals 
FilllnClone 

Finalize 

GetHashCode 

GetType 
GetValue 
GetValuelmpI 
IModifier.GetValue 



Determines whether two Object instances are equal. Inherited from 
Object 

Allows an Object to attempt to free resources and perform other 
cleanup operations before the Object is reclaimed by garbage 
collection. Inherited from Object. 

Serves as a hash function for a particular type, suitable for use in 
hashing algorithms and data structures like a hash table. Inherited from 
Object. 

Gets the Type of the current instance. Inherited from Object. 
Inherited from BoolModifier. 
Inherited from BoolModifier. 
Inherited from Modifier. 
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MakeUnchangeable 

MakeUnchangeableCore 
MemberwiseClone 

ModifyHandlerlfChangeable 



OnChanged 

opjmplicit 
Pause 

PropagateEventHandler 
Read Preamble 

ReferenceEquals 

Resume 

Seek 

SetDefaultParentTimeline 
ToString 

ValidateObjectState 
WritePostscript 

WritePreamble 



Makes an object immutable; after this method is called on a 
Changeable, its IsChangeable property is false. Inherited from 
Changeable. 

MakeUnchangeableCore Inherited from Modifier. 
Creates a shallow copy of the current Object. Inherited from Object. 
Adds or removes a Changed event handler to or from the specified 
Changeable object, if the object is currently modifiable. If the specified 
object is not modifiable — if its IsChangeable property is false — this 
method has no effect. Inherited from Changeable. 

Called when the current object is modified. Classes that derive from 
Changed should call this method after they have been 
modified. Inherited from Changeable. 

Implicitly creates an AnimationCollection from a BoolModifier Inherited 
from BoolModifier. 

Pauses this timeline. 

Ensures that simple (non-Changeable) members are being accessed 
from a valid user interface (Ul) context. This method should be called 
before any simple members are accessed. Inherited from Changeable. 

Determines whether the specified Object instances are the same 
instance. Inherited from Object. 

Resumes this timeline. 

Moves the current position of the animation backwards or forwards from 
either the current time, the Begin time, or the End time. 

SetDefaultParentTimeline Inherited from Modifier. 

Returns a String that represents the current Object Inherited from 
Object. 

Verifies that the current object has a valid state. If the object is in an 
invalid state, this method throws an exception. Inherited from 
Changeable. 

Causes the current object to validate itself and then invokes the 
OnChanged method. Inherited from Changeable. 

Ensures that simple (non-Changeable) members are being accessed 
from a valid Ul context. This method should be called before any simple 
members are set. Inherited from Changeable. 



Property Description 

Acceleration Gets or sets the fraction of the simple duration spent in the 

acceleration phase. 

Used in conjunction with the ChangeableUsageOverride type sent in 

AllowChangeableReferenceOverride " 8 P arame * er t0 ChangeableHelper.UseChangeable, to help 

determine when a Changeable being put into use should be 
promoted to "ChangeableReference". Inherited from Changeable. 

AutoReverse Gets or sets a value that lndicates whether the animation plays in 

reverse after it completes its forward iteration. 

Begin Gets or sets an offset to the start time of the animation. 

True if this Changeable can be made unchangeable. Inherited from 
Changeable. 



CanMakeUnchangeable 



CurrentRepeat 



Gets the number of the current iteration of the animation. 
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CurrentTime 
Deceleration 

Duration 
End 

EndSync 
Fill 

FillDefault 

IsChangeable 

IsChanging 
IsEnabled 

IsForwardProgressing 

IsOverridingBaseValue 

IsPaused 

IsReversed 
ParentTimeline 
Progress 
RepeatCount 

RepeatDuration 
Restart 

RestartDefault 
Speed 



StatusOfNextUse 



Timeline 
UlContext 



Gets the current time value of the animation. 

Gets or sets a value that represents the fraction of the simple 
duration spent in the deceleration phase. 

Gets or sets the length of time the animation takes to complete a 
single forward iteration, also known as the simple duration of an 
animation. 

Gets or sets the maximum end time of the animation. 

Not supported. Gets or sets a TimeEndSync enumeration that 

specifies how the implicit duration of an animation is determined. 

This property is only used if the Duration property is not explicitly 

set. 

Gets or sets a value that specifies the state of an object when its 
animation ends. 

Gets or sets a value that indicates the default value of the Fill 
property of the current animation and its child timelines. 
Gets a Boolean that indicates whether the object is currently 
modifiable. Inherited from Changeable. 

Gets a value that indicates whether the animation is active. 

Gets a value that indicates whether the animation is progressing 
from past to future. 

Gets a value that indicates whether the animation is active or in a fill 
period. 

Gets a value that indicates whether the animation is active and 
paused. 

Gets a value that indicates whether the animation is currently 
moving in the opposite direction of its parent timeline. 
Gets or sets the default parent timeline of the animation. 

Gets a number from 0 to 1 that indicates the fraction of the simple 
duration that has elapsed. 

Gets or sets the number of times an animation should repeat. 
Gets or sets the total length of time the animation should play. If this 
value is greater than the simple duration of the animation, the 
animation will repeat itself for the length of time specified by this 
property. 

Gets or sets the animation's behavior when it is told to restart— that 
is, how the animation behaves when a second begin time is 
reached. 

Gets or sets the default value of the Restart property of the current 
animation and its child timelines. 

Gets or sets the relative speed at which time should pass for the 
animation, compared to its parent timeline. 

Gets or sets a UseStatus enumeration that specifies how the 
Changeable object behaves when it is "used." A Changeable object 
is considered used in the following situations: the object is set into a 
Property System property, the object is used as a sub-object in a 
complex Changeable object, or the object is used in a 
DrawingContext command. Inherited from Changeable. 
Timeline 

Gets the UlContext of the current object. The UlContext is used for 
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UsesBaseValue 



maintaining thread safety. Inherited from Changeable. 
UsesBaseValue Inherited from Modifier. 



ByteAnimati nCollection Class 

Definition: Represents a collection of BoolModifier animations. 



Method 

Add 

AddChild 
AddText 
Apply 

ByteAnimationCollection 

Clear 
CloneCore 

CloneDownToUnchangeable 
Contains 

Copy 

Copy 

CopyTo 

Disable 
Disablelmpl 



Description 

Adds animations to the collection. 

Implementation of AddChild. Adds a Modifier to this AnimationCollection 
from Markup. 

Implementation of AddText. This is not implemented on this class. 

Implementation of Apply. Applies an animation collection in markup to 
an element. 

Creates an empty ByteAnimationCollection with a default capacity for a 
single animation. 

CloneCore 

Returns an immutable copy of the specified object. Inherited from 
Changeable. 

Returns a modifiable copy of the current object. The copy's 
IsChangeable property is true and its StatusOfNextUse is 
Unchangeable. Inherited from Changeable. 

Creates a copy of this ByteAnimationCollection. 
Copies the entire ByteAnimationCollection to the specified one- 
dimensional array, starting at the specified index of the target array. 
Inherited from AnimationCollection. 



Accesses the specified Changeable data member, processes it, and 
returns a reference to the member. This reference should then be 
EmbeddedChangeableReader reassigned to the original member variable. Classes that derive from 

Changeable call this method on data members before they can be 
retrieved through property calls. Inherited from Changeable. 
Processes a modified Changeable data member and returns a 
reference to the processed object. Inherited from Changeable. 
Inherited from AnimationCollection. 



EmbeddedChangeableWriter 

Enable 
Enablelmpl 

Equals 



Finalize 

GetEnumerator 
GetEnumeratorlmpI 

GetHashCode 

GetType 



Determines whether two Object instances are equal. Inherited from 
Object. 

Allows an Object to attempt to free resources and perform other cleanup 
operations before the Object is reclaimed by garbage 
collection. Inherited from Object. 

GetEnumerator Inherited from AnimationCollection. 

Returns an object that can be used to enumerate items in the list. 

Serves as a hash function for a particular type, suitable for use in 

hashing algorithms and data structures like a hash table. Inherited from 

Object. 

Gets the Type of the current instance. Inherited from Object. 



338 



GetValue 
GetValuelmpI 
IndexOf 
Insert 

MakeUnchangeable 

MakeUnchangeableCore 
MemberwiseClone 

ModifyHandlerlfChangeable 

OnChanged 
op_Addition 
opjmplicit 

PropagateEventHandler 
ReadPreamble 

ReferenceEquals 

Remove 
RemoveAt 

SetDefaultParentTimeline 
SetValuelmpI 

ToString 

ValidateObjectState 
WritePostscript 

WritePreamble 



Returns the current value of the animation. 
Provides a Modifier at a given index. 



Makes an object immutable; after this method is called on a 
Changeable, its IsChangeable property is false. Inherited from 
Changeable. 

Implementation of MakeUnchangeableCore. 

Creates a shallow copy of the current Object. Inherited from Object. 

Adds or removes a Changed event handler to or from the specified 

Changeable object, if the object is currently modifiable. If the specified 

object is not modifiable— if its IsChangeable property is false— this 

method has no effect. Inherited from Changeable. 

OnChanged 



Implementation of PropagateEventHandler. 

Ensures that simple (non-Changeable) members are being accessed 
from a valid Ul context. This method should be called before any simple 
members are accessed. Inherited from Changeable. 

Determines whether the specified Object instances are the same 
instance. Inherited from Object. 



Inherited from AnimationCollection. 
Sets a Modifier at a given index. 

Returns a String that represents the current Object. Inherited from 
Object. 

Verifies that the current object has a valid state. If the object is in an 
invalid state, this method throws an exception. Inherited from 
Changeable. 

Causes the current object to validate itself and then invokes the 
OnChanged method. Inherited from Changeable. 
Ensures that simple (non-Changeable) members are being accessed 
from a valid user interface (Ul) context. This method should be called 
before any simple members are set. Inherited from Changeable. 



Property Description 

Used in conjunction with the ChangeableUsageOverride type sent in 

AllowChangeableReferenceOverride as a P arameterto ChangeableHelper.UseChangeable, to help 

determine when a Changeable being put into "use" should be 
promoted to "ChangeableReference". Inherited from Changeable. 

AnimationType AnimationType 

True if this Changeable can be made unchangeable. Inherited from 
Changeable. 

Count Inherited from AnimationCollection. 

Countlmpl 

Em P*y An unchangeable empty ByteAnimationCollection. 



CanMakeUnchangeable 
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IsChangeable 

IsChanging 

IsFixedSize 

IsOverridingBaseValue 

IsReadOnly 

IsSynchronized 

IsUsingBaseValue 

IsUsingBaseValuelmpI 

Item 

Item 



StatusOfNextUse 

SyncRoot 
UlContext 



Gets a Boolean that indicates whether the object is currently 
modifiable. Inherited from Changeable. 

Returns true if at least one of the animations in the animation list is 
currently active. Inherited from AnimationCollection. 

Returns true if at least one of the animations in the animation list is 
currently on. Inherited from AnimationCollection. 



Inherited from AnimationCollection. 
this - typed version of indexer 

Use this to get or set a Modifier at a given index. Inherited from 
AnimationCollection. 

Gets or sets a UseStatus enumeration that specifies how the 
Changeable object behaves when it is "used." A Changeable object 
is considered used in the following situations: the object is set into a 
Property System property, the object is used as a sub-object in a 
complex Changeable object, or the object is used in a 
DrawingContext command. Inherited from Changeable. 

Gets the UlContext of the current object. The UlContext is used for 
maintaining thread safety. Inherited from Changeable. 



AnimationCollection provide you with more control over how you animate a property than a single 
animation could. Each of the AnimationCollection classes effectively functions as a single composite 
animation, using all the animations in the collection to animate a base value. When a property requests 
the current value of an AnimationCollection, the property calls the AnimationCollection's GetValue method 
and passes it the property's base value. The first animation in the collection processes this base value 
and produces a result, which is then passed to the next animation in the collection, and so on, until the 
value has been processed by all the animations in the collection. 



This example demonstrates how to animate a property using "Longhorn" markup language (code-named 
"XAML"). To animate a property, you associate the proper animation collection and animations with the 
property either directly or using the property's corresponding animation property. There are a variety of 
animation classes, each of which animates a different kind of value. 

Before some properties can be animated, they must be given a base value. For example, before 
animating the RectangleWidth of a Rectangle, the RectangleWidth must be set to a non-animated value 
(in this case, a Length object). 

In the following example, the Width of a Button is animated. Because the Width property takes a Length, 
a Length Animation is needed. A LengthAnimationCollection is used to contain the LengthAnimation. 
Although in this example there is only one animation, you could associate multiple animations with a 
single property by placing the animations within the collection. Because there is no WidthAnimations 
property, the LengthAnimationCollection is associated directly with the button's Width property. 

<Canvas ID="root" 
xmlns="http://schemas.microsoft.com/2003/xamr , > 



<Button Canvas.Top="20" Canvas. Left="20" 
Height="30" Width="200 M > 
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<Button.Width> 
<LengthAnimationCollection> 

<LengthAnimation To="50" Duration="5" RepeatCount="500 M 
AutoReverse="True , V> 
</LengthAnimationCollection> 
</Button.Width> 

A Button 
</Button> 

In the next example, the Background color of a second button is animated. The Background property 
takes a Brush. In this example, a SolidColorBrush is used to fill the button's Background, although a 
gradient, image, or pattern could have been used. To animate the button's background color, the Color of 
the SolidColorBrush must be animated. Because the SolidColorBrush. Color property accepts a Color, a 
ColorAnimation is used to animate the property. The SolidColorBrush.Color property has a corresponding 
ColorAnimations property, so the ColorAnimation is nested within the ColorAnimations property in order 
to animate the color of the brush. 

<Button Canvas.Top="70" Canvas. Left="20" 
Height="30" Width="200"> 

<Button.Background> 
<SolidColorBrush Color="Blue"> 
<SolidColorBrush.ColorAnimations> 
<ColorAnimation From="Red" To="Blue" Duration="7" 
RepeatCount="500" AutoReverse="True7> 
</SolidColorBrush.ColorAnimations> 
</SolidColorBrush> 
</Button.Background> 

Another Button 
</Button> 

</Canvas> 

In the previous example, the ColorAnimationCollection tag, <ColorAnimationCollection>, is omitted when 
animating the brush's color. When animating a designated animation property— properties of the form 
PropertyNameAnimations, such as the ColorAnimations property in the previous example— you may omit 
the animation collection tag. However, when animating a property of a Ul element— those classes that 
derive from UlElement— you must nest the animations within an animation collection tag. 
For more information about animating properties, see Animation in "Avalon". 



ByteModifier Class 

Description 

Returns a modifiable shallow or deep clone of the current object. This 
abstract method must be implemented by classes that derive from 
Changeable. Inherited from Changeable. 

Returns an immutable copy of the specified object. Inherited from 
CloneDownToUnchangeable Chan 9 eab,e 



Method 

ByteModifier 

CloneCore 
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Returns a modifiable copy of the current object. The copy's 
Copy IsChangeable property is true and its StatusOfNextUse is 

Unchangeable. Inherited from Changeable. 
Copy Creates a copy of this ByteModifier 

Accesses the specified Changeable data member, processes it, and 
returns a reference to the member. This reference should then be 
EmbeddedChangeableReader reassigned to the original member variable. Classes that derive from 

Changeable call this method on data members before they can be 
retrieved through property calls. Inherited from Changeable. 
Processes a modified Changeable data member and returns a 
reference to the processed object. Inherited from Changeable. 

Determines whether two Object instances are equal. Inherited from 
Object. 

Allows an Object to attempt to free resources and perform other cleanup 
operations before the Object is reclaimed by garbage 
collection. Inherited from Object. 

Serves as a hash function for a particular type, suitable for use in 
GetHashCode hashing algorithms and data structures like a hash table. Inherited from 

Object. 

Gets the Type of the current instance. Inherited from Object. 



EmbeddedChangeableWriter 
Equals 

Finalize 



GetType 
GetValue 
GetValuelmpI 
IModifier.GetValue 

MakeUnchangeable 

MakeUnchangeableCore 
MemberwiseClone 

ModifyHandlerlfChangeable 



OnChanged 
opjmplicit 

PropagateEventHandler 

ReadPreamble 

ReferenceEquals 

SetDefaultParentTimeline 

ToString 

ValidateObjectState 
WritePostscript 



Inherited from Modifier. 

Makes an object immutable; after this method is called on a 
Changeable, its IsChangeable property is false. Inherited from 
Changeable. 

MakeUnchangeableCore Inherited from Modifier. 
Creates a shallow copy of the current Object. Inherited from Object. 
Adds or removes a Changed event handler to or from the specified 
Changeable object, if the object is currently modifiable. If the specified 
object is not modifiable— if its IsChangeable property is false— this 
method has no effect Inherited from Changeable. 

Called when the current object is modified. Classes that derive from 
Changed should call this method after they have been 
modified. Inherited from Changeable. 

Implicitly creates an AnimationCollection from a ByteModifier 
Shares a Changed event handler with the current object's data 
members or removes it. Inherited from Changeable. 
Ensures that simple (non-Changeable) members are being accessed 
from a valid Ul context. This method should be called before any simple 
members are accessed. Inherited from Changeable. 

Determines whether the specified Object instances are the same 
instance. Inherited from Object. 

SetDefaultParentTimeline Inherited from Modifier. 

Returns a String that represents the current Object. Inherited from 
Object. 

Verifies that the current object has a valid state. If the object is in an 
invalid state, this method throws an exception. Inherited from 
Changeable. 

Causes the current object to validate itself and then invokes the 
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WritePreamble 



OnChanged method. Inherited from Changeable. 

Ensures that simple (non-Changeable) members are being accessed 
from a valid user interface (Ul) context. This method should be called 
before any simple members are set. Inherited from Changeable. 



Property Description 

Used in conjunction with the ChangeableUsageOverride type sent in 

AllowChangeableReferenceOverride f f a P aram ^er to ChangeabteHelper.UseChangeable, to help 
* determine when a Changeable being put into use should be 

promoted to "ChangeableReference". Inherited from Changeable. 

True if this Changeable can be made unchangeable. Inherited from 
Changeable. 

Gets a Boolean that indicates whether the object is currently 
modifiable. Inherited from Changeable. 

Gets a value that indicates whether the animation is active. Inherited 
from Modifier. 



CanMakeUnchangeable 
IsChangeable 



IsChanging 



IsOverriding Base Value 

StatusOfNextUse 

UlContext 
UsesBaseValue 



Gets a value that indicates whether the animation is active or in a fill 
period. Inherited from Modifier. 

Gets or sets a UseStatus enumeration that specifies how the 
Changeable object behaves when it is "used." A Changeable object 
is considered used in the following situations: the object is set into a 
Property System property, the object is used as a sub-object in a 
complex Changeable object, or the object is used in a 
DrawingContext command. Inherited from Changeable. 

Gets the UlContext of the current object. The UlContext is used for 
maintaining thread safety. Inherited from Changeable. 

UsesBaseValue Inherited from Modifier. 



ByteTimedModifier Class 



Method 



Beginln 



ByteTimedModifier 
CloneCore 

CloneDownToUnchangeable 
Copy 

Copy 

Copy 
Disable 



Description 

Starts or restarts the animation at the specified offset from the current 
time. 

Returns a modifiable shallow or deep clone of the current object. This 
abstract method must be implemented by classes that derive from 
Changeable. Inherited from Changeable. 

Returns an immutable copy of the specified object. Inherited from 
Changeable. 

Creates a copy of this ByteTimedModifier 

Returns a modifiable copy of the current object. The copy's 
IsChangeable property is true and its StatusOfNextUse is 
Unchangeable. Inherited from Changeable. 

Creates a copy of this ByteModifier Inherited from ByteModifier. 

Disables this timeline, after which the timeline can no longer become 
active. The timeline can be re-enabled with a call to Enable. 



Accesses the specified Changeable data member, processes it, and 
EmbeddedChangeableReader returns a reference to the member. This reference should then be 
reassigned to the original member variable. Classes that derive from 
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EmbeddedChangeableWriter 

Enable 

Endln 

Equals 

FilllnClone 

Finalize 

GetHashCode 

GetType 
GetValue 
GetValuelmpI 
IModifier.GetValue 

MakeUnchangeable 

MakeUnchangeableCore 
MemberwiseClone 

ModifyHandlerlfChangeable 

OnChanged 

opjmplicit 
Pause 

PropagateEventHandler 
ReadPreamble 

ReferenceEquals 

Resume 

Seek 

SetDefaultParentTimeline 
ToString 

ValidateObjectState 



Changeable call this method on data members before they can be 
retrieved through property calls. Inherited from Changeable. 
Processes a modified Changeable data member and returns a 
reference to the processed object. Inherited from Changeable. 
Enables this timeline, parenting it to the timeline specified by the 
ParentTimeline property. This allows the timeline to become active. This 
method throws an exception if the ParentTimeline property is null. 
Schedules an interactive end time. 

Determines whether two Object instances are equal. Inherited from 
Object. 

Allows an Object to attempt to free resources and perform other cleanup 
operations before the Object is reclaimed by garbage 
collection. Inherited from Object. 

Serves as a hash function for a particular type, suitable for use in 
hashing algorithms and data structures like a hash table. Inherited from 
Object. 

Gets the Type of the current instance. Inherited from Object. 
Inherited from ByteModifier. 
Inherited from ByteModifier. 
Inherited from Modifier. 

Makes an object immutable; after this method is called on a 
Changeable, its IsChangeable property is false. Inherited from 
Changeable. 

MakeUnchangeableCore Inherited from Modifier. 
Creates a shallow copy of the current Object. Inherited from Object. 
Adds or removes a Changed event handler to or from the specified 
Changeable object, if the object is currently modifiable. If the specified 
object is not modifiable— if its IsChangeable property is false— this 
method has no effect. Inherited from Changeable. 

Called when the current object is modified. Classes that derive from 
Changed should call this method after they have been 
modified. Inherited from Changeable. 

Implicitly creates an AnimationCollection from a ByteModifier Inherited 
from ByteModifier. 

Pauses this timeline. 

Ensures that simple (non-Changeable) members are being accessed 
from a valid user interface (Ul) context. This method should be called 
before any simple members are accessed. Inherited from Changeable. 
Determines whether the specified Object instances are the same 
instance. Inherited from Object. 

Resumes this timeline. 

Moves the current position of the animation backwards or forwards from 
either the current time, the Begin time, or the End time. 

SetDefaultParentTimeline Inherited from Modifier. 

Returns a String that represents the current Object. Inherited from 
Object. 

Verifies that the current object has a valid state. If the object is in an 



344 



WritePostscript 
WritePreamble 



invalid state, this method throws an exception. Inherited from 
Changeable. 

Causes the current object to validate itself and then invokes the 
OnChanged method. Inherited from Changeable. 

Ensures that simple (non-Changeable) members are being accessed 
from a valid Ul context. This method should be called before any simple 
members are set. Inherited from Changeable. 



Property 

Acceleration 

AllowChangeableReferenceOverride 

AutoReverse 
Begin 

CanMakeUnchangeable 

CurrentRepeat 
CurrentTime 

Deceleration 

Duration 
End 

EndSync 
Fill 

FillDefault 

IsChangeable 

IsChanging 
IsEnabled 

IsForwardProgressing 
IsOverridingBaseValue 
IsPaused 

IsReversed 

ParentTimeline 
Progress 



Description 

Gets or sets the fraction of the simple duration spent in the 
acceleration phase. 

Used in conjunction with the ChangeableUsageOverride type sent in 
as a parameter to ChangeableHelper.UseChangeable, to help 
determine when a Changeable being put into "use" should be 
promoted to "ChangeableReference". Inherited from Changeable. 
Gets or sets a value that indicates whether the animation plays in 
reverse after it completes its forward iteration. 

Gets or sets an offset to the start time of the animation. 

True if this Changeable can be made unchangeable. Inherited from 
Changeable. 

Gets the number of the current iteration of the animation. 

Gets the current time value of the animation. 

Gets or sets a value that represents the fraction of the simple 
duration spent in the deceleration phase. 

Gets or sets the length of time the animation takes to complete a 
single forward iteration, also known as the simple duration of an 
animation. 

Gets or sets the maximum end time of the animation. 
Gets or sets a TimeEndSync enumeration that specifies how the 
implicit duration of an animation is determined. This property is only 
used if the Duration property is not explicitly set. 

Gets or sets a value that specifies the state of an object when its 
animation ends. 

Gets or sets a value that indicates the default value of the Fill 
property of the current animation and its child timelines. 

Gets a Boolean that indicates whether the object is currently 
modifiable. Inherited from Changeable. 

Gets a value that indicates whether the animation is active. 

Gets a value that indicates whether the animation is progressing 
from past to future. 

Gets a value that indicates whether the animation is active or in a fill 
period. 

Gets a value that indicates whether the animation is active and 
paused. 

Gets a value that indicates whether the animation is currently 
moving in the opposite direction of its parent timeline. 
Gets or sets the default parent timeline of the animation. 
Gets a number from 0 to 1 that indicates the fraction of the simple 
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RepeatCount 
RepeatDuration 

Restart 

RestartDefault 
Speed 

StatusOfNextUse 

Timeline 

UlContext 

UsesBaseValue 



duration that has elapsed. 

Gets or sets the number of times an animation should repeat. 
Gets or sets the total length of time the animation should play. If this 
value is greater than the simple duration of the animation, it will 
repeat itself for the length of time specified by this property. 
Gets or sets the animation's behavior when it is told to restart— that 
is, how the animation behaves when a second begin time is 
reached. 

Gets or sets the default value of the Restart property of the current 
animation and its child timelines. 

Gets or sets the relative speed at which time should pass for the 
animation, compared to its parent timeline. 
Gets or sets a UseStatus enumeration that specifies how the 
Changeable object behaves when it is "used." A Changeable object 
is considered used in the following situations: the object is set into a 
Property System property, the object is used as a sub-object in a 
complex Changeable object, or the object is used in a 
DrawingContext command. Inherited from Changeable. 
Timeline 

Gets the UlContext of the current object. The UlContext is used for 
maintaining thread safety. Inherited from Changeable. 
UsesBaseValue Inherited from Modifier. 



CharAnimationCollection Class 

Definition: Represents a collection of CharModifier animations. 



Method 



Add 



AddChild 
AddText 
Apply 

CharAnimationCollection 

Clear 
CloneCore 

CloneDownToUnchangeable 
Contains 

Copy 

Copy 
CopyTo 



Description 

The Add(CharModifier) and Add(Object) methods add animations to the 
collection. The Add(Char,CharAnimationCollection) method calculates 
the current value of the specified collection based on the specified base 
value. 

Implementation of AddChild. Adds a Modifier to this AnimationCollection 
from Markup. 

Implementation of AddText. This is not implemented on this class. 

Implementation of Apply. Applies an animation collection in markup to 
an element. 

Creates an empty CharAnimationCollection with a default capacity for a 
single animation. 

Clears the collection by setting the collection's Count to 0. 
CloneCore 

Returns an immutable copy of the specified object. Inherited from 
Changeable. 

Returns a Boolean that indicates whether the collection contains the 
specified CharModifier. 

Returns a modifiable copy of the current object. The copy's 
IsChangeable property is true and its StatusOfNextUse is 
Unchangeable. Inherited from Changeable. 
Creates a copy of this CharAnimationCollection. 
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Disable 
Disablelmpl 



Inherited from AnimationCollection. 



Accesses the specified Changeable data member, processes it, and 
returns a reference to the member. This reference should then be 
EmbeddedChangeableReader reassigned to the original member variable. Classes that derive from 

Changeable call this method on data members before they can be 
retrieved through property calls. Inherited from Changeable. 
Processes a modified Changeable data member and returns a reference 
to the processed object. Inherited from Changeable. 
Inherited from AnimationCollection. 



EmbeddedChangeableWriter 

Enable 
Enablelmpl 

Equals 



Finalize 

GetEnumerator 
GetEnumeratorlmpI 

GetHashCode 

GetType 

GetValue 

GetValuelmpI 

IndexOf 

Insert 

MakeUnchangeable 

MakeUnchangeableCore 
MemberwiseClone 

ModifyHandlerlfChangeable 

OnChanged 
op_Addition 
opjmplicit 

PropagateEventHandler 
ReadPreamble 

ReferenceEquals 

Remove 
RemoveAt 

SetDefaultParentTimeline 
SetValuelmpI 



Determines whether two Object instances are equal. Inherited from 
Object. 

Allows an Object to attempt to free resources and perform other cleanup 
operations before the Object is reclaimed by garbage 
collection. Inherited from Object. 

GetEnumerator Inherited from AnimationCollection. 

Returns an object that can be used to enumerate items in the list. 

Serves as a hash function for a particular type, suitable for use in 

hashing algorithms and data structures like a hash table. Inherited from 

Object. 

Gets the Type of the current instance. Inherited from Object. 
Returns the current value of the animation. 
Provides a Modifier at a given index. 



Makes an object immutable; after this method is called on a 
Changeable, its IsChangeable property is false. Inherited from 
Changeable. 

Implementation of MakeUnchangeableCore. 

Creates a shallow copy of the current Object. Inherited from Object. 

Adds or removes a Changed event handler to or from the specified 

Changeable object, if the object is currently modifiable. If the specified 

object is not modifiable— if its IsChangeable property is false— this 

method has no effect. Inherited from Changeable. 

OnChanged 



Implementation of PropagateEventHandler. 

Ensures that simple (non-Changeable) members are being accessed 
from a valid Ul context. This method should be called before any simple 
members are accessed. Inherited from Changeable. 

Determines whether the specified Object instances are the same 
instance. Inherited from Object. 



Inherited from AnimationCollection. 
Sets a Modifier at a given index. 
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ToString 

ValidateObjectState 
WritePostscript 

WritePreamble 



Returns a String that represents the current Object. Inherited from 
Object. 

Verifies that the current object has a valid state. If the object is in an 
invalid state, this method throws an exception. Inherited from 
Changeable. 

Causes the current object to validate itself and then invokes the 
OnChanged method. Inherited from Changeable. 
Ensures that simple (non-Changeable) members are being accessed 
from a valid user interface (Ul) context. This method should be called 
before any simple members are set. Inherited from Changeable. 



Property Description 

Used in conjunction with the ChangeableUsageOverride type sent in 

AllowChangeableReferenceOverride *" P arame t er ChangeableHelper.UseChangeable, to help 

determine when a Changeable being put into "use" should be 
promoted to "ChangeableReference". Inherited from Changeable. 
AnimationType 

True if this Changeable can be made unchangeable. Inherited from 
Changeable. 

Inherited from AnimationCollection. 



AnimationType 
CanMakeUnchangeable 



Count 
Countlmpl 
Empty 

IsChangeable 

IsChanging 

IsFixedSize 

IsOverridingBaseValue 

IsReadOnly 

IsSynchronized 

IsUsingBaseValue 

IsUsingBaseValuelmpI 

Item 

Item 



StatusOfNextUse 

SyncRoot 
U I Context 



An unchangeable empty CharAnimationCollection, 

Gets a Boolean that indicates whether the object is currently 
modifiable. Inherited from Changeable. 

Returns true if at least one of the animations in the animation list is 
currently active. Inherited from AnimationCollection. 

Returns true if at least one of the animations in the animation list is 
currently on. Inherited from AnimationCollection. 



Inherited from AnimationCollection. 
this - typed version of indexer 

Use this to get or set a Modifier at a given index. Inherited from 
AnimationCollection. 

Gets or sets a UseStatus enumeration that specifies how the 
Changeable object behaves when it is "used." A Changeable object 
is considered used in the following situations: the object is set into a 
Property System property, the object is used as a sub-object in a 
complex Changeable object, or the object is used in a 
DrawingContext command. Inherited from Changeable. 

Gets the UlContext of the current object. The UlContext is used for 
maintaining thread safety. Inherited from Changeable. 



The AnimationCollection classes, such as CharAnimationCollection, provide you with more control over 
how you animate a property than a single animation could. Each of the AnimationCollection classes 
effectively functions as a single composite animation, using all the animations in the collection to animate 
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a base value. When a property requests the current value of an CharAnimationCollection, the property 
calls the CharAnimationCollection's GetValue method and passes it the property's base value. The first 
animation in the collection processes this base value and produces a result, which is then passed to the 
next animation in the collection, and so on, until the value has been processed by all the animations in the 
collection. 

This example demonstrates how to animate a property using "Longhorn" markup language (code-named 
"XAML"). To animate a property, you associate the proper animation collection and animations with the 
property either directly or using the property's corresponding animation property. There are a variety of 
animation classes, each of which animates a different kind of value. 

Before some properties can be animated, they must be given a base value. For example, before 
animating the RectangleWidth of a Rectangle, the RectangleWidth must be set to a non-animated value 
(in this case, a Length object). 

In the following example, the Width of a Button is animated. Because the Width property takes a Length, 
a LengthAnimation is needed. A LengthAnimationCollection is used to contain the LengthAnimation. 
Although in this example there is only one animation, you could associate multiple animations with a 
single property by placing the animations within the collection. Because there is no WidthAnimations 
property, the LengthAnimationCollection is associated directly with the button's Width property. 

<Canvas ID="root" 
xmlns="http://schemas.microsoft.com/2003/xaml"> 

<Button Canvas.Top= n 20" Canvas. Left="20" 
Height="30" Width="200"> 

<Button.Width> 
<LengthAnimationCollection> 
<LengthAnimation To="50" Duration="5" RepeatCount="500" 
AutoReverse="True"/> 
</LengthAnimationCollection> 
</Button.Width> 

A Button 
</Button> 

In the next example, the Background color of a second button is animated. The Background property 
takes a Brush. In this example, a SolidColorBrush is used to fill the button's Background, although a 
gradient, image, or pattern could have been used. To animate the button's background color, the Color of 
the SolidColorBrush must be animated. Because the SolidColorBrush.Color property accepts a Color, a 
ColorAnimation is used to animate the property. The SolidColorBrush.Color property has a corresponding 
ColorAnimations property, so the ColorAnimation is nested within the ColorAnimations property in order 
to animate the color of the brush. 

<Button Canvas.Top="70" Canvas. Left= M 20" 
Height="30" Width= M 200"> 

<Button.Background> 
<SolidColorBrush Color="Blue"> 
<SolidColorBrush.ColorAnimations> 
<ColorAnimation From="Red" To="Blue" Duration="7" 
RepeatCount="500" AutoReverse="True7> 
</SolidColorBrush . ColorAn i mations> 
</SolidColorBrush> 
</Button.Background> 
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Another Button 
</Button> 

</Canvas> 

In the previous example, the ColorAnimationCollection tag, <ColorAnimationCollection>, is omitted when 
animating the brush's color. When animating a designated animation property— properties of the form 
PropertyNameAnimations, such as the ColorAnimations property in the previous example — you may omit 
the animation collection tag. However, when animating a property of a Ul element— those classes that 
derive from UlElement— you must nest the animations within an animation collection tag. 



CharModifier Class 



Method 

CharModifier 



Description 



CloneCore 

CloneDownToUnchangeable 
Copy 

Copy 



Returns a modifiable shallow or deep clone of the current object. This 
abstract method must be implemented by classes that derive from 
Changeable. Inherited from Changeable. 

Returns an immutable copy of the specified object. Inherited from 
Changeable. 

Creates a copy of this CharModifier 

Returns a modifiable copy of the current object. The copy's 
IsChangeable property is true and its StatusOfNextUse is 
Unchangeable. Inherited from Changeable. 

Accesses the specified Changeable data member, processes it, and 
returns a reference to the member. This reference should then be 
EmbeddedChangeableReader reassigned to the original member variable. Classes that derive from 

Changeable call this method on data members before they can be 
retrieved through property calls. Inherited from Changeable. 

Processes a modified Changeable data member and returns a reference 
to the processed object. Inherited from Changeable. 

Determines whether two Object instances are equal. Inherited from 
Object. 

Allows an Object to attempt to free resources and perform other cleanup 
operations before the Object is reclaimed by garbage 
collection. Inherited from Object. 

Serves as a hash function for a particular type, suitable for use in 
hashing algorithms and data structures like a hash table. Inherited from 
Object. 

Gets the Type of the current instance. Inherited from Object. 



EmbeddedChangeableWriter 
Equals 

Finalize 
GetHashCode 



GetType 
GetValue 
GetValuelmpI 
I Modifier. GetValue 

MakeUnchangeable 

MakeUnchangeableCore 

MemberwiseClone 

ModifyHandlerlfChangeable 



Inherited from Modifier. 

Makes an object immutable; after this method is called on a 
Changeable, its IsChangeable property is false. Inherited from 
Changeable. 

MakeUnchangeableCore Inherited from Modifier. 

Creates a shallow copy of the current Object. Inherited from Object. 

Adds or removes a Changed event handler to or from the specified 



350 



OnChanged 
opjmplicit 

PropagateEventHandler 

Read Preamble 

ReferenceEquals 

SetDefaultParentTimeline 

ToString 

ValidateObjectState 
WritePostscript 

WritePreamble 



Changeable object, if the object is currently modifiable. If the specified 
object is not modifiable— if its IsChangeable property is false— this 
method has no effect. Inherited from Changeable. 

Called when the current object is modified. Classes that derive from 
Changed should call this method after they have been 
modified. Inherited from Changeable. 

Implicitly creates an AnimationCollection from a CharModifier 

Shares a Changed event handler with the current object's data members 
or removes it. Inherited from Changeable. 

Ensures that simple (non-Changeable) members are being accessed 
from a valid Ul context. This method should be called before any simple 
members are accessed. Inherited from Changeable. 

Determines whether the specified Object instances are the same 
instance. Inherited from Object. 

SetDefaultParentTimeline Inherited from Modifier. 

Returns a String that represents the current Object. Inherited from 
Object. 

Verifies that the current object has a valid state. If the object is in an 
invalid state, this method throws an exception. Inherited from 
Changeable. 

Causes the current object to validate itself and then invokes the 
OnChanged method. Inherited from Changeable. 

Ensures that simple (non-Changeable) members are being accessed 
from a valid user interface (Ul) context. This method should be called 
before any simple members are set. Inherited from Changeable. 



Property 

AllowChangeableReferenceOverride 

CanMakeUnchangeable 

IsChangeable 

IsChanging 

IsOverridingBaseValue 

StatusOfNextUse 

UlContext 
UsesBaseValue 



Description 

Used in conjunction with the ChangeableUsageOverride type sent 
in as a parameter to ChangeableHelper.UseChangeable, to help 
determine when a Changeable being put into "use" should be 
promoted to "ChangeableReference". Inherited from Changeable. 
True if this Changeable can be made unchangeable. Inherited 
from Changeable. 

Gets a Boolean that indicates whether the object is currently 
modifiable. Inherited from Changeable. 

Gets a value that indicates whether the animation is 
active. Inherited from Modifier. 

Gets a value that indicates whether the animation is active or in a 
fill period. Inherited from Modifier. 

Gets or sets a UseStatus enumeration that specifies how the 
Changeable object behaves when it is "used." A Changeable 
object is considered used in the following situations: the object is 
set into a Property System property, the object is used as a sub- 
object in a complex Changeable object, or the object is used in a 
DrawingContext command. Inherited from Changeable. 
Gets the UlContext of the current object. The UlContext is used for 
maintaining thread safety. Inherited from Changeable. 
UsesBaseValue Inherited from Modifier. 
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CharTimedM difier Class 



Meth d 

Beginln 

CharTimedModifier 
CloneCore 

CloneDownToUnchangeable 
Copy 



Descripti n 

Starts or restarts the animation at the specified offset from the current 
time. 

Returns a modifiable shallow or deep clone of the current object. This 
abstract method must be implemented by classes that derive from 
Changeable. Inherited from Changeable. 

Returns an immutable copy of the specified object. Inherited from 
Changeable. 

Creates a copy of this CharModifier Inherited from CharModifier. 
Returns a modifiable copy of the current object. The copy's 
IsChangeable property is true and its StatusOfNextUse is 
Unchangeable. Inherited from Changeable. 
Creates a copy of this CharTimedModifier 

Disables this timeline, after which the timeline can no longer become 
active. The timeline can be re-enabled with a call to Enable. 
Accesses the specified Changeable data member, processes it, and 
returns a reference to the member. This reference should then be 
EmbeddedChangeableReader reassigned to the original member variable. Classes that derive from 

Changeable call this method on data members before they can be 
retrieved through property calls. Inherited from Changeable. 
Processes a modified Changeable data member and returns a 
reference to the processed object. Inherited from Changeable. 
Enables this timeline, parenting it to the timeline specified by the 
ParentTimeline property. This allows the timeline to become active. This 
method throws an exception if the ParentTimeline property is null. 
Schedules an interactive end time. 



Copy 

Copy 
Disable 



EmbeddedChangeableWriter 

Enable 
Endln 



Equals 
FilllnClone 

Finalize 

GetHashCode 

GetType 
GetValue 
GetValuelmpI 
IModifier.GetValue 

MakeUnchangeable 

MakeUnchangeableCore 
MemberwiseClone 

ModifyHandlerlfChangeable 



Determines whether two Object instances are equal. Inherited from 
Object. 

Allows an Object to attempt to free resources and perform other cleanup 
operations before the Object is reclaimed by garbage 
collection. Inherited from Object. 

Serves as a hash function for a particular type, suitable for use in 
hashing algorithms and data structures like a hash table. Inherited from 
Object. 

Gets the Type of the current instance. Inherited from Object. 
Inherited from CharModifier. 
Inherited from CharModifier. 
Inherited from Modifier. 

Makes an object immutable; after this method is called on a 
Changeable, its IsChangeable property is false. Inherited from 
Changeable. 

MakeUnchangeableCore Inherited from Modifier. 
Creates a shallow copy of the current Object. Inherited from Object. 
Adds or removes a Changed event handler to or from the specified 
Changeable object, if the object is currently modifiable. If the specified 
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OnChanged 

opjmplicit 
Pause 

PropagateEventHandler 
ReadPreamble 

ReferenceEquals 

Resume 

Seek 

SetDefaultParentTimeline 
ToString 

ValidateObjectState 
WritePostscript 

WritePreamble 



Property 



Acceleration 



object is not modifiable— if its IsChangeable property is false— this 
method has no effect. Inherited from Changeable. 
Called when the current object is modified. Classes that derive from 
Changed should call this method after they have been 
modified. Inherited from Changeable. 

Implicitly creates an AnimationCollection from a CharModifier Inherited 
from CharModifier. 

Pauses this timeline. 

Ensures that simple (non-Changeable) members are being accessed 
from a valid user interface (Ul) context. This method should be called 
before any simple members are accessed. Inherited from Changeable. 
Determines whether the specified Object instances are the same 
instance. Inherited from Object. 

Resumes this timeline. 

Moves the current position of the animation backwards or forwards from 
either the current time, the Begin time, or the End time. 

SetDefaultParentTimeline Inherited from Modifier. 

Returns a String that represents the current Object. Inherited from 
Object. 

Verifies that the current object has a valid state. If the object is in an 
invalid state, this method throws an exception. Inherited from 
Changeable. 

Causes the current object to validate itself and then invokes the 
OnChanged method. Inherited from Changeable. 
Ensures that simple (non-Changeable) members are being accessed 
from a valid Ul context. This method should be called before any simple 
members are set. Inherited from Changeable. 



AllowChangeableReferenceOverride 

AutoReverse 
Begin 

CanMakeUnchangeable 

CurrentRepeat 
CurrentTime 

Deceleration 

Duration 
End 



Description 

Gets or sets the fraction of the simple duration spent in the 
acceleration phase. 

Used in conjunction with the ChangeableUsageOverride type sent 
in as a parameter to ChangeableHelper.UseChangeable, to help 
determine when a Changeable being put into "use" should be 
promoted to "ChangeableReference". Inherited from Changeable. 
Gets or sets a value that indicates whether the animation plays in 
reverse after it completes its forward iteration. 
Gets or sets an offset to the start time of the animation. 

True if this Changeable can be made unchangeable. Inherited 
from Changeable. 

Gets the number of the current iteration of the animation. 

Gets the current time value of the animation. 

Gets or sets a value that represents the fraction of the simple 
duration spent in the deceleration phase. 

Gets or sets the length of time the animation takes to complete a 
single forward iteration, also known as the simple duration of an 
animation. 

Gets or sets the maximum end time of the animation. 
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EndSync 
Fill 

FillDefault 

IsChangeable 

IsChanging 
IsEnabled 

IsForwardProgressing 

IsOverridingBaseValue 

IsPaused 

IsReversed 
ParentTimeline 
Progress 
RepeatCount 

RepeatDuration 

Restart 

RestartDefault 
Speed 

StatusOfNextUse 

Timeline 

UlContext 

UsesBaseValue 



Gets or sets a TimeEndSync enumeration that specifies how the 
implicit duration of an animation is determined. This property is 
only used if the Duration property is not explicitly set. 

Gets or sets a value that specifies the state of an object when its 
animation ends. 

Gets or sets a value that indicates the default value of the Fill 
property of the current animation and its child timelines. 
Gets a Boolean that indicates whether the object is currently 
modifiable. Inherited from Changeable. 

Gets a value that indicates whether the animation is active. 

Gets a value that indicates whether the animation is progressing 
from past to future. 

Gets a value that indicates whether the animation is active or in a 
fill period. 

Gets a value that indicates whether the animation is active and 
paused. 

Gets a value that indicates whether the animation is currently 
moving in the opposite direction of its parent timeline. 
Gets or sets the default parent timeline of the animation. 

Gets a number from 0 to 1 that indicates the fraction of the simple 
duration that has elapsed. 

Gets or sets the number of times an animation should repeat. 
Gets or sets the total length of time the animation should play. If 
this value is greater than the simple duration of the animation, it 
will repeat itself until the time specified by this property. 
Gets or sets the animation's behavior when it is told to restart- 
that is, how the animation behaves when a second begin time is 
reached. 

Gets or sets the default value of the Restart property of the current 
animation and its child timelines. 

Gets or sets the relative speed at which time should pass for the 
animation, compared to its parent timeline. 

Gets or sets a UseStatus enumeration that specifies how the 
Changeable object behaves when it is "used." A Changeable 
object is considered used in the following situations: the object is 
set into a Property System property, the object is used as a sub- 
object in a complex Changeable object, or the object is used in a 
DrawingContext command. Inherited from Changeable. 
Timeline 

Gets the UlContext of the current object. The UlContext is used for 
maintaining thread safety. Inherited from Changeable. 
UsesBaseValue Inherited from Modifier. 



ColorAnimation Class 

Definition: Animates a color value of a property. 

Method Description 

Be ginln Starts or restarts the animation at the specified offset from the current 
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CloneCore 

CloneDownToUnchangeable 

ColorAnimation 
Copy 

Copy 
Copy 

Disable 



time. Inherited from ColorTimedModifier. 
Implementation of CloneCore. 

Returns an immutable copy of the specified object. Inherited from 
Changeable. 

Initializes a new instance of the ColorAnimation class. 

Creates a copy of this ColorModifier Inherited from ColorModifier. 

Creates a copy of this ColorTimedModifier Inherited from 
ColorTimedModifier. 

Returns a modifiable copy of the current object. The copy's 
IsChangeable property is true and its StatusOfNextUse is 
Unchangeable. Inherited from Changeable. 

Disables this timeline, after which the timeline can no longer become 
active. The timeline can be re-enabled with a call to Enable. Inherited 
from ColorTimedModifier. 



Accesses the specified Changeable data member, processes it, and 
returns a reference to the member. This reference should then be 
EmbeddedChangeableReader reassigned to the original member variable. Classes that derive from 

Changeable call this method on data members before they can be 
retrieved through property calls. Inherited from Changeable. 
Processes a modified Changeable data member and returns a 
reference to the processed object. Inherited from Changeable. 
Enables this timeline, parenting it to the timeline specified by the 
ParentTimeline property. This allows the timeline to become active. This 
method throws an exception if the ParentTimeline property is 
null. Inherited from ColorTimedModifier. 

Schedules an interactive end time. Inherited from ColorTimedModifier. 



EmbeddedChangeableWriter 



Enable 



Endln 
Equals 
FilllnClone 

Finalize 

GetHashCode 

GetType 
GetValue 
GetValuelmpI 
IModifier.GetValue 

MakeUnchangeable 

MakeUnchangeableCore 
MemberwiseClone 

ModifyHandlerlfChangeable 

OnChanged 



Determines whether two Object instances are equal. Inherited from 
Object. 

Inherited from ColorTimedModifier. 

Allows an Object to attempt to free resources and perform other cleanup 
operations before the Object is reclaimed by garbage 
collection. Inherited from Object. 

Serves as a hash function for a particular type, suitable for use in 
hashing algorithms and data structures like a hash table. Inherited from 
Object 

Gets the Type of the current instance. Inherited from Object. 
Calculates the current value of the animation. 

Inherited from ColorModifier. 

Inherited from Modifier. 

Makes an object immutable; after this method is called on a 
Changeable, its IsChangeable property is false. Inherited from 
Changeable. 

MakeUnchangeableCore Inherited from Modifier. 

Creates a shallow copy of the current Object. Inherited from Object. 

Adds or removes a Changed event handler to or from the specified 

Changeable object, if the object is currently modifiable. If the specified 

object is not modifiable— if its IsChangeable property is false— this 

method has no effect. Inherited from Changeable. 

Called when the current object is modified. Classes that derive from 
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OP— Implicit 
Pause 

PropagateEventHandler 
ReadPreamble 

Reference Equals 
Resume 

Seek 

SetDefaultParentTimeline 
ToString 

ValidateObjectState 
WritePostscript 

WritePreamble 



Changed should call this method after they have been 
modified. Inherited from Changeable. 

Implicitly creates an AnimationCollection from a ColorModifier Inherited 
from ColorModifier. 

Pauses this timeline. Inherited from ColorTimedModifier. 
PropagateEventHandler 

Ensures that simple (non-Changeable) members are being accessed 
from a valid Ul context. This method should be called before any simple 
members are accessed. Inherited from Changeable. 

Determines whether the specified Object instances are the same 
instance. Inherited from Object. 

Resumes this timeline. Inherited from ColorTimedModifier. 

Moves the current position of the animation backwards or forwards from 

either the current time, the Begin time, or the End time. Inherited from 

ColorTimedModifier. 

Returns a String that represents the current Object. Inherited from 
Object. 

Verifies that the current object has a valid state. If the object is in an 
invalid state, this method throws an exception. Inherited from 
Changeable. 

Causes the current object to validate itself and then invokes the 
OnChanged method. Inherited from Changeable. 

Ensures that simple (non-Changeable) members are being accessed 
from a valid user interface (Ul) context. This method should be called 
before any simple members are set. Inherited from Changeable. 



Property Description 

Acceleration Gets or sets the fraction of the simple duration spent in the 

^ v acceleration phase. Inherited from ColorTimedModifier. 

Used in conjunction with the ChangeableUsageOverride type sent in 

AllowChangeableReferenceOverride " 8 P aram€ f r to ChangeaWeHelper.UseChangeable, to help 

determine when a Changeable being put into "use" should be 
promoted to "ChangeableReference". Inherited from Changeable. 
Gets or sets a value that indicates whether the animation plays in 

AutoReverse reverse after it completes its forward iteration. Inherited from 

ColorTimedModifier. 



Begin 
By 

CanMakeUnchangeable 

CurrentRepeat 

CurrentTime 

Deceleration 



Gets or sets an offset to the start time of the animation. Inherited 
from ColorTimedModifier. 

Gets or sets the total amount by which the animation changes its 
starting value. 

True if this Changeable can be made unchangeable. Inherited from 
Changeable. 

Gets the number of the current iteration of the animation. Inherited 
from ColorTimedModifier. 

Gets the current time value of the animation. Inherited from 
ColorTimedModifier. 

Gets or sets a value that represents the fraction of the simple 
duration spent in the deceleration phase. Inherited from 
ColorTimedModifier. 
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Duration 
End 

EndSync 
Fill 

FillDefault 
From 

InterpolationMethod 

IsAdditive 

IsChangeable 

IsChanging 

IsCumulative 
IsEnabled 

IsForwardProgressing 

IsOverridingBaseValue 

IsPaused 

IsReversed 

KeyFrames 
ParentTimeline 

Progress 

RepeatCount 

RepeatDuration 
Restart 

RestartDefault 
Speed 



Gets or sets the length of time the animation takes to complete a 
single forward iteration, also known as the simple duration of an 
animation. Inherited from ColorTimedModifier. 

Gets or sets the maximum end time of the animation. Inherited from 
ColorTimedModifier. 

Gets or sets a TimeEndSync enumeration that specifies how the 
implicit duration of an animation is determined. This property is only 
used if the Duration property is not explicitly set. Inherited from 
ColorTimedModifier. 

Gets or sets a value that specifies the state of an object when its 
animation ends. Inherited from ColorTimedModifier. 
Gets or sets a value that indicates the default value of the Fill 
property of the current animation and its child timelines. Inherited 
from ColorTimedModifier. 

Gets or sets the starting value of an animation. 

Gets or sets a value that specifies how output values are calculated 
for the animation. 

IsAdditive 

Gets a Boolean that indicates whether the object is currently 
modifiable. Inherited from Changeable. 

Gets a value that indicates whether the animation is active. Inherited 
from ColorTimedModifier. 

IsCumulative 

Inherited from ColorTimedModifier. 

Gets a value that indicates whether the animation is progressing 
from past to future. Inherited from ColorTimedModifier. 
Gets a value that indicates whether the animation is active or in a fill 
period. Inherited from ColorTimedModifier. 

Gets a value that indicates whether the animation is active and 
paused. Inherited from ColorTimedModifier. 

Gets a value that indicates whether the animation is currently 
moving in the opposite direction of its parent timeline. Inherited from 
ColorTimedModifier. 

KeyValues 

Gets or sets the default parent timeline of the animation. Inherited 
from ColorTimedModifier. 

Gets a number from 0 to 1 that indicates the fraction of the simple 
duration that has elapsed. Inherited from ColorTimedModifier. 
Gets or sets the number of times an animation should 
repeat. Inherited from ColorTimedModifier. 

Gets or sets the total length of time the animation should play. If this 
value is greater than the simple duration of the animation, it will 
repeat itself for the length of time specified by this 
property. Inherited from ColorTimedModifier. 

Gets or sets the animation's behavior when it is told to restart— that 
is, how the animation behaves when a second begin time is 
reached. Inherited from ColorTimedModifier. 

Gets or sets the default value of the Restart property of the current 
animation and its child timelines. Inherited from ColorTimedModifier. 
Gets or sets the relative speed at which time should pass for the 
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StatusOfNextUse 

Timeline 
To 

UlContext 
UsesBaseValue 



animation, compared to its parent timeline. Inherited from 
ColorTimedModifier. 

Gets or sets a UseStatus enumeration that specifies how the 
Changeable object behaves when it is "used." A Changeable object 
is considered used in the following situations: the object is set into a 
Property System property, the object is used as a sub-object in a 
complex Changeable object, or the object is used in a 
DrawingContext command. Inherited from Changeable. 
Timeline Inherited from ColorTimedModifier. 
Gets or sets the ending value of the animation. 

Gets the UlContext of the current object. The UlContext is used for 
maintaining thread safety. Inherited from Changeable. 



This example shows how to animate the Fill color of a Ellipse. 
<Canvas ID="root" 

xmlns=''http://schemas.microsoft.com/2003/xamr 
xmlns:def="Definition"> 



<Ellipse CenterX="200" CenterY= M 200" RadiusX = "100" RadiusY = "100" > 
<Ellipse.Fill> 
<SolidColorBrush> 
<SolidColorBrush.ColorAnimations> 

<!-- Because the AutoReverse property is set to True, the color will animate back to 
Red after it animates to Blue. --> 

<ColorAnimation From="Red" To="Blue" Begin="0" Duration="5" 
AutoReverse="True" RepeatCount="100"/> 
</SolidColorBrush.ColorAnimations> 
</SolidColorBrush> 
</Ellipse.Fill> 
</Ellipse> 



</Canvas> 



In the previous example, the ColorAnimationCollection tag, <ColorAnimationCollection> is omitted when 
animating the brush's color. When animating a designated animation property— properties of the form 
PropertyNameAnimations, such as the ColorAnimations property in the previous example— you may omit 
the animation collection tag. However, when animating a property of a Ul element— those classes that 
derive from UlElement— you must nest the animations within an animation collection tag. For more 
information about animating properties, see Animation in "Avalon". 

This example demonstrates how to use the By, From, and To properties of animations to set an 
animation's starting and ending values in "Longhorn" markup language (code-named "XAML"). In the 
following markup, LengthAnimation objects are used to animate the endpoints of five Line elements. 
Although this example uses the LengthAnimation, the behavior of the From, To, and By properties is the 
same for all the animation classes. 

In the first markup fragment, the X2 attribute of the first line is animated from 50 to 100 over a duration of 
10 seconds. Because the From and To properties of the LengthAnimation are set, the animation ignores 
the line's base value, starting at the specified From value and moving toward the specified To value. 

<Canvas ID="root" 
xmlns="http://schemas.microsoft.com/2003/xaml"> 
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<Line ID="Line1" X1= M 10" Y1="10" X2= M 100" Y2="50" 
Stroke="Black" StrokeThickness="5"> 
<Line.X2> 
<LengthAnimationCollection> 

<LengthAnimation From="50" To="300" Duration="10" RepeatCount="50" /> 
</LengthAnimationCollection> 
</Line.X2> 
</Line> 

The second line's animation has only its To property set. When the From value of an animation isn't set, 
the animation uses the base value of the property it is animating or the ending value of a previous 
animation. In this example, the animation uses the base value of the line's X2 property, 100, as its starting 



<Line ID="Line2" X1="10" Y1="70" X2="100" Y2="70" Stroke="Black" StrokeThickness="5"> 
<Line.X2> 

<LengthAnimationCollection> 

<LengthAnimation To="300" Durational 0" RepeatCount="50" /> 
</LengthAnimationCollection> 
</Line.X2> 
</Line> 

The third line's animation has only its By property set. The By of an animation specifies "by how much" 
the animation changes a value over its duration. As in the previous example, the animation uses the base 
value of the property it is animating or the ending value of a previous animation. In this example the 
animation uses the base value of the line's X2 property, 100, as its starting value, and adds 300 to that 
value over a duration of 1 0 seconds. 

<Line ID="Line3" X1="10" Y1="130" X2="100" Y2="130" Stroke="Black" StrokeThickness="5"> 
<Line.X2> 

<LengthAnimationCollection> 

<LengthAnimation By="300" Durational 0" RepeatCount="50" /> 
</LengthAnimationCollection> 
</Line.X2> 
</Line> 



The fourth line's animation has its By and From properties set. As a result, the line's X2 attribute is 
animated from 50 to to 350 over a duration of 10 seconds. 

<Line ID="Line4" X1="10" Y1="190" X2="100" Y2="190" Stroke="Black" StrokeThickness="5"> 
<Line.X2> 

<LengthAnimationCollection> 

<LengthAnimation From="50" By="300" Duration="10" RepeatCount="50" /> 
</LengthAnimationCollection> 
</Line.X2> 
</Line> 



The fifth line's animation has only its From value set. When an animation has no explicit destination value 
it uses the base value of the property it is animating or the output of a previous animation as its 
destination value. In this case, the line's X2 attribute is animated from 50 to 100. 

<Line ID="Line5" X1="10" Y1="250" X2="100" Y2="250" Stroke="Black" StrokeThickness="5"> 
<Line.X2> 
<LengthAnimationCollection> 
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<LengthAnimation From= M 50" Duration="10" RepeatCount="50" /> 
</LengthAnimationCollection> 
</Line.X2> 
</Line> 

</Canvas> 

This example demonstrates how to animate a property using "XAML". To animate a property, you 
associate the proper animation collection and animations with the property either directly or using the 
property's corresponding animation property. There are a variety of animation classes, each of which 
animates a different kind of value. 

Before some properties can be animated, they must be given a base value. For example, before 
animating the RectangleWidth of a Rectangle, the RectangleWidth must be set to a non-animated value 
(in this case, a Length object). 

In the following example, the Width of a Button is animated. Because the Width property takes a Length, 
a LengthAnimation is needed. A LengthAnimationCollection is used to contain the LengthAnimation. 
Although in this example there is only one animation, you could associate multiple animations with a 
single property by placing the animations within the collection. Because there is no WidthAnimations 
property, the LengthAnimationCollection is associated directly with the button's Width property. 

<Canvas ID="root n 
xmlns="http://schemas.microsoft.com/2003/xaml M > 

<Button Canvas.Top="20" Canvas. Left="20" 
Height="30" Width="200"> 

<Button.Width> 
<LengthAnimationCollection> 
<LengthAnimation To="50" Duration="5" RepeatCount="500" 
AutoReverse="True"/> 
</LengthAnimationCollection> 
</Button.Width> 

A Button 
</Button> 

In the next example, the Background color of a second button is animated. The Background property 
takes a Brush. In this example, a SolidColorBrush is used to fill the button's Background, although a 
gradient, image, or pattern could have been used. To animate the button's background color, the Color of 
the SolidColorBrush must be animated. Because the SolidColorBrush.Color property accepts a Color a 
ColorAnimation is used to animate the property. The SolidColorBrush.Color property has a corresponding 
ColorAnimations property, so the ColorAnimation is nested within the ColorAnimations property in order 
to animate the color of the brush. 

<Button Canvas.Top="70" Canvas. Left="20" 
Height="30" Width="200"> 

<Button. Background> 
<SolidColorBrush Color="Blue"> 
<SolidColorBrush.ColorAnimations> 
<ColorAnimation From="Red" To="Blue" Duration="7" 
RepeatCou nt="500" AutoRe verse='True"/> 
</SolidColorBrush.ColorAnimations> 
</SolidColorBrush> 
</Button.Background> 
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Another Button 
</Button> 

</Canvas> 

In the previous example, the ColorAnimationCollection tag, <ColorAnimationCollection> is omitted when 
animating the brush's color. When animating a designated animation property— properties of the form 
PropertyNameAnimations, such as the ColorAnimations property in the previous example— you may omit 
the animation collection tag. However, when animating a property of a Ul element— those classes that 
derive from UlElement— you must nest the animations within an animation collection tag. 
For more information about animating properties, see Animation in "Avalon". 

This example demonstrates how to create an animation that repeats indefinitely. To make an animation 
repeat indefinitely in M XAML", set the animation's RepeatDuration property to Indefinite. In code, set the 
animation's RepeatDuration property to Time. Indefinite or set its RepeatCount property to 
double. Positivelnfinity. 

In the following examples, a LengthAnimation is set to repeat indefinitely. Although this example uses a 
LengthAnimation, the procedure is the same for all the animation classes. 

<Canvas ID="root" 
xmlns="http://schemas.microsoft.com/2003/xaml"> 

<Line X1="10" Y1="20" X2="50" Y2= n 20" 
StrokeThickness="1 0" Stroke="Black"> 
<Line.X2> 

<LengthAnimationCollection> 

<LengthAnimation From="30" To="300" Duration-' 10" 
RepeatDuration="lndefinite" /> 
</LengthAnimationCollection> 
</Line.X2> 
</Line> 

</Canvas> 

//C# 

Line myLine = new Line(); 

LengthAnimation myLengthAnimation = new LengthAnimation(); 
myLengthAnimation.From = new Length(30); 
myLengthAnimation.To = new Length(300); 
myLengthAnimation. Duration = new Time(IOOOO); 
myLengthAnimation. RepeatDuration = Time. Indefinite; 

LengthAnimationCollection collection = new LengthAnimationCollection(); 
collection.Add(myLengthAnimation); 

myLine.SetAnimations(Line.X2Property, collection); 
'VB.NET 

Dim myLine As new MSAvalon.Windows.Shapes.Line 

Dim myLengthAnimation As new MSAvalon.Windows.Media.Animation. LengthAnimation 
myLengthAnimation.From = new MSA valon. Windows. Length(30) 
myLengthAnimation.To = new MSAvalon. Windows. Length(300) 
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myLengthAnimation. Duration = new MSAvalon.Windows.Media.Animation.Time(IOOOO) 
myLengthAnimation.RepeatDuration = _ 
MSAvalon.Windows.Media.Animation.Time.lndefinite 

Dim collection As new MSAvalon.Windows.Media.Animation.LengthAnimationCollection 
collection.Add(myLengthAnimation) 

myLine.SetAnimations(Line.X2Property, collection) 
ColorAnimationColtection Class 

Definition: Represents a collection of ColorModifier animations. 



Method 

Add 

AddChild 

AddText 

Apply 

Clear 
CloneCore 

CloneDownToUnchangeable 

ColorAnimationCollection 

Contains 

Copy 

Copy 

CopyTo 

Disable 
Disablelmpl 



Description 

Adds animations to the collection. 

Implementation of AddChild. Adds a Modifier to this AnimationCollection 
from Markup. 

Implementation of AddText. This is not implemented on this class. 

Implementation of Apply. Applies an animation collection in markup to 
an element. 

Clears the collection by setting the collection's Count to 0. 
CloneCore 

Returns an immutable copy of the specified object. Inherited from 
Changeable. 

Initializes a new instance of the ColorAnimationCollection class. 

Returns a Boolean that indicates whether the collection contains the 
specified ColorModifier. 

Creates a copy of this ColorAnimationCollection. 
Returns a modifiable copy of the current object. The copy's 
IsChangeable property is true and its StatusOfNextUse is 
Unchangeable. Inherited from Changeable. 

Copies the entire ColorAnimationCollection to the specified one- 
dimensional array, starting at the specified index of the target array. 
Inherited from AnimationCollection. 



Accesses the specified Changeable data member, processes it, and 
returns a reference to the member. This reference should then be 
EmbeddedChangeableReader reassigned to the original member variable. Classes that derive from 

Changeable call this method on data members before they can be 
retrieved through property calls. Inherited from Changeable. 

Processes a modified Changeable data member and returns a reference 
to the processed object. Inherited from Changeable. 

Inherited from AnimationCollection. 



EmbeddedChangeableWriter 

Enable 
Enablelmpl 

Equals 
Finalize 

GetEnumerator 



Determines whether two Object instances are equal. Inherited from 
Object. 

Allows an Object to attempt to free r sources and p rform other cleanup 
operations before the Object is reclaimed by garbage 
collection. Inherited from Object. 

GetEnumerator Inherited from AnimationCollection. 
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GetEnumeratorlmpI 

GetHashCode 

GetType 

GetValue 

GetValuelmpI 

IndexOf 

Insert 

MakeUnchangeable 

MakeUnchangeableCore 
MemberwiseClone 

ModifyHandlerlfChangeable 

OnChanged 
op_Addition 
opjmplicit 

PropagateEventHandler 
ReadPreamble 

ReferenceEquals 

Remove 
RemoveAt 

SetDefaultParentTimeline 
SetValuelmpI 

ToString 

ValidateObjectState 
WritePostscript 

WritePreamble 



Returns an object that can be used to enumerate items in the list. 
Serves as a hash function for a particular type, suitable for use in 
hashing algorithms and data structures like a hash table. Inherited from 
Object. 

Gets the Type of the current instance. Inherited from Object. 
Calculates and returns the output of the animation collection. 
Provides a Modifier at a given index. 



Makes an object immutable; after this method is called on a 
Changeable, its IsChangeable property is false. Inherited from 
Changeable. 

Implementation of MakeUnchangeableCore. 

Creates a shallow copy of the current Object. Inherited from Object. 

Adds or removes a Changed event handler to or from the specified 

Changeable object, if the object is currently modifiable. If the specified 

object is not modifiable— if its IsChangeable property is false— this 

method has no effect. Inherited from Changeable. 

OnChanged 



Implementation of PropagateEventHandler. 

Ensures that simple (non-Changeable) members are being accessed 
from a valid Ul context. This method should be called before any simple 
members are accessed. Inherited from Changeable. 

Determines whether the specified Object instances are the same 
instance. Inherited from Object. 



Inherited from AnimationCollection. 
Sets a Modifier at a given index. 

Returns a String that represents the current Object. Inherited from 
Object. 

Verifies that the current object has a valid state. If the object is in an 
invalid state, this method throws an exception. Inherited from 
Changeable. 

Causes the current object to validate itself and then invokes the 
OnChanged method. Inherited from Changeable. 
Ensures that simple (non-Changeable) members are being accessed 
from a valid user interface (Ul) context. This method should be called 
before any simple members are set. Inherited from Changeable. 



Property Description 

Used in conjunction with the ChangeableUsageOverride type sent in 

AllowChangeableReferenceOverride * s a P arameter t0 ChangeableHelper.UseChangeable, to help 

determine when a Changeable being put into "use" should be 
promoted to "ChangeableReference". Inherited from Changeable. 

AnimationType Gets the type of animation stored in the collection. 
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True if this Changeable can be made unchangeable. Inherited from 
Changeable. 

Inherited from AnimationCollection. 



An unchangeable empty ColorAnimationCollection. 

Gets a Boolean that indicates whether the object is currently 
modifiable. Inherited from Changeable. 

Returns true if at least one of the animations in the animation list is 
currently active. Inherited from AnimationCollection. 

Returns true if at least one of the animations in the animation list is 
currently on. Inherited from AnimationCollection. 



Inherited from AnimationCollection. 

Gets or sets the animation at the specified index. 

Use this to get or set a Modifier at a given index. Inherited from 
AnimationCollection. 

Gets or sets a UseStatus enumeration that specifies how the 
Changeable object behaves when it is "used." A Changeable object 
is considered used in the following situations: the object is set into a 
Property System property, the object is used as a sub-object in a 
complex Changeable object, or the object is used in a 
DrawingContext command. Inherited from Changeable. 

Gets the UlContext of the current object. The UlContext is used for 
maintaining thread safety. Inherited from Changeable. 

The AnimationCollection classes, such as ColorAnimationCollection, provide you with more control over 
how you animate a property than a single animation could. Each of the AnimationCollection classes 
effectively functions as a single composite animation, using all the animations in the collection to animate 
a base value. When a property requests the current value of an ColorAnimationCollection, the property 
calls the ColorAnimationCollection's GetValue method and passes it the property's base value. The first 
animation in the collection processes this base value and produces a result, which is then passed to the 
next animation in the collection, and so on, until the value has been processed by all the animations in the 
collection. 

This example demonstrates how to animate a property using "Longhorn" markup language (code-named 
"XAML"). To animate a property, you associate the proper animation collection and animations with the 
property either directly or using the property's corresponding animation property. There are a variety of 
animation classes, each of which animates a different kind of value. 

Before some properties can be animated, they must be given a base value. For example, before 
animating the RectangleWidth of a Rectangle, the RectangleWidth must be set to a non-animated value 
(in this case, a Length object). 

In the following example, the Width of a Button is animated. Because the Width property takes a Length, 
a LengthAnimation is needed. A LengthAnimationCollection is used to contain the LengthAnimation. 
Although in this example there is only one animation, you could associate multiple animations with a 



CanMakeUnchangeable 

Count 

Countlmpl 

Empty 

IsChangeable 

IsChanging 

IsFixedSize 

IsOverridingBaseValue 

IsReadOnly 
IsSynchronized 
IsUsingBaseValue 
IsUsingBaseValuelmpI 
Item 

Item 

StatusOfNextUse 

SyncRoot 
UlContext 
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single property by placing the animations within the collection. Because there is no WidthAnimations 
property, the LengthAnimationCollection is associated directly with the button's Width property. 

<Canvas ID="root" 
xmlns= ,, http://schemas.microsoft.com/2003/xamr , > 

<Button Canvas.Top="20" Canvas. Left="20" 
Height="30" Width="200"> 

<Button.Width> 
<LengthAnimationCollection> 

<LengthAnimation To="50" Duration="5 M RepeatCount="500" 
AutoReverse="True7> 
</LengthAnimationCollection> 
</Button.Width> 

A Button 
</Button> 

In the next example, the Background color of a second button is animated. The Background property 
takes a Brush. In this example, a SolidColorBrush is used to fill the button's Background, although a 
gradient, image, or pattern could have been used. To animate the button's background color the Color of 
the SolidColorBrush must be animated. Because the SolidColorBrush.Color property accepts a Color a 
ColorAnimation is used to animate the property. The SolidColorBrush.Color property has a corresponding 
ColorAnimations property, so the ColorAnimation is nested within the ColorAnimations property in order 
to animate the color of the brush. 

<Button Canvas.Top="70 n Canvas. Left="20" 
Height="30" Width="200"> 

<Button.Background> 
<SolidColorBrush Color="Blue"> 
<SolidColorBrush.ColorAnimations> 
<ColorAnimation From="Red" To="Blue" Duration="7" 
RepeatCount="500" AutoReverse="True7> 
</SolidColorBrush.ColorAnimations> 
</SolidColorBrush> 
</Button.Background> 

Another Button 
</Button> 

</Canvas> 

In the previous example, the ColorAnimationCollection tag, <ColorAnimationCollection>, is omitted when 
animating the brush's color. When animating a designated animation property— properties of the form 
PropertyNameAnimations, such as the ColorAnimations property in the previous example— you may omit 
the animation collection tag. However, when animating a property of a Ul element— those classes that 
derive from UlElement— you must nest the animations within an animation collection tag. 



ColorKeyFrameCollection Class 

Meth d Descripti n 

Add Strongly typed implementation of Add. 
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CloneCore 

CloneDownToUnchangeable 
ColorKeyFrameCollection 

Copy 
Copy 

EmbeddedChangeableReader 

EmbeddedChangeableWriter 
Equals 

Finalize 

GetCurrentSegmentValues 
GetHashCode 
GetType 

MakeUnchangeable 

MakeUnchangeableCore 
MemberwiseClone 

ModifyHandlerlfChangeable 
OnChanged 

PropagateEventHandler 
Read Preamble 

ReferenceEquals 

ToString 
Validate 

ValidateObjectState 
WritePostscript 



Implementation of CloneCore. 

Returns an immutable copy of the specified object. Inherited from 
Changeable. 

Returns a modifiable copy of the current object. The copy's 
IsChangeable property is true and its StatusOfNextUse is 
Unchangeable. Inherited from Changeable. 
Creates a new ColorKeyFrameCollection 

Accesses the specified Changeable data member, processes it, and 
returns a reference to the member. This reference should then be 
reassigned to the original member variable. Classes that derive from 
Changeable call this method on data members before they can be 
retrieved through property calls. Inherited from Changeable. 
Processes a modified Changeable data member and returns a 
reference to the processed object. Inherited from Changeable. 

Determines whether two Object instances are equal. Inherited from 
Object. 

Allows an Object to attempt to free resources and perform other cleanup 
operations before the Object is reclaimed by garbage 
collection. Inherited from Object. 
TODO 

Serves as a hash function for a particular type, suitable for use in 
hashing algorithms and data structures like a hash table. Inherited from 
Object. 

Gets the Type of the current instance. Inherited from Object. 
Makes an object immutable; after this method is called on a 
Changeable, its IsChangeable property is false. Inherited from 
Changeable. 

Makes a Changeable object immutable. Inherited from Changeable. 
Creates a shallow copy of the current Object. Inherited from Object. 
Adds or removes a Changed event handler to or from the specified 
Changeable object, if the object is currently modifiable. If the specified 
object is not modifiable— if its IsChangeable property is false— this 
method has no effect. Inherited from Changeable. 
Called when the current object is modified. Classes that derive from 
Changed should call this method after they have been 
modified. Inherited from Changeable. 

Shares a Changed event handler with the current object's data 
members or removes it. Inherited from Changeable. 
Ensures that simple (non-Changeable) members are being accessed 
from a valid Ul context. This method should be called before any simple 
members are accessed. Inherited from Changeable. 

Determines whether the specified Object instances are the same 
instance. Inherited from Object. 

Returns a String that represents the current Object. Inherited from 
Object. 

Implementation of ValidateObjectState. 
Causes the current object to validate itself and then invokes the 
OnChanged method. Inherited from Changeable. 
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WritePreamble 



Ensures that simple (non-Changeable) members are being accessed 
from a valid user interface (Ul) context. This method should be called 
before any simple members are set. Inherited from Changeable. 



Property 

AllowChangeableReferenceOverride 



CanMakeUnchangeabie 

Count 
Destination 

IsChangeable 

Item 



StatusOfNextUse 



UlContext 



Description 

Used in conjunction with the ChangeableUsageOverride type sent 
in as a parameter to ChangeableHelper.UseChangeable, to help 
determine when a Changeable being put into "use" should be 
promoted to "ChangeableReference". Inherited from Changeable. 

True if this Changeable can be made unchangeable. Inherited 
from Changeable. 

Implementation of Count. 

The value specified in the last KeyFrame. 

Gets a Boolean that indicates whether the object is currently 
modifiable. Inherited from Changeable. 

Gets or sets a UseStatus enumeration that specifies how the 
Changeable object behaves when it is "used." A Changeable 
object is considered used in the following situations: the object is 
set into a Property System property, the object is used as a sub- 
object in a complex Changeable object, or the object is used in a 
DrawingContext command. Inherited from Changeable. 
Gets the UlContext of the current object. The UlContext is used for 
maintaining thread safety. Inherited from Changeable. 



ColorModifier Class 



Method 

CloneCore 

CloneDownToUnchangeable 

ColorModifier 
Copy 

Copy 



EmbeddedChangeableReader 

EmbeddedChangeableWriter 
Equals 



Description 

Returns a modifiable shallow or deep clone of the current object. This 
abstract method must be implemented by classes that derive from 
Changeable. Inherited from Changeable. 

Returns an immutable copy of the specified object. Inherited from 
Changeable. 

Creates a copy of this ColorModifier 

Returns a modifiable copy of the current object. The copy's 

IsChangeable property is true and its StatusOfNextUse is 

Unchangeable. Inherited from Changeable. 

Accesses the specified Changeable data member, processes it, and 

returns a reference to the member. This reference should then be 

reassigned to the original member variable. Classes that derive from 

Changeable call this method on data members before they can be 

retrieved through property calls. Inherited from Changeable. 

Processes a modified Changeable data member and returns a 

reference to the processed object. Inherited from Changeable. 

Determines whether two Object instances are equal. Inherited from 
Object. 
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Finalize 

GetHashCode 

GetType 
GetValue 
GetValuelmpI 
IModifier.GetValue 

MakeUnchangeable 

MakeUnchangeableCore 
MemberwiseClone 

ModifyHandlerlfChangeable 



OnChanged 
opjmplicit 

PropagateEventHandler 

ReadPreamble 

ReferenceEquals 

SetDefaultParentTimeline 

ToString 

ValidateObjectState 
WritePostscript 

WritePreamble 



Allows an Object to attempt to free resources and perform other cleanup 
operations before the Object is reclaimed by garbage 
collection. Inherited from Object. 

Serves as a hash function for a particular type, suitable for use in 
hashing algorithms and data structures like a hash table. Inherited from 
Object. 

Gets the Type of the current instance. Inherited from Object. 



Inherited from Modifier. 

Makes an object immutable; after this method is called on a 
Changeable, its IsChangeable property is false. Inherited from 
Changeable. 

MakeUnchangeableCore Inherited from Modifier. 

Creates a shallow copy of the current Object. Inherited from Object. 

Adds or removes a Changed event handler to or from the specified 

Changeable object, if the object is currently modifiable. If the specified 

object is not modifiable— if its IsChangeable property is false— this 

method has no effect. Inherited from Changeable. 

Called when the current object is modified. Classes that derive from 

Changed should call this method after they have been 

modified. Inherited from Changeable. 

Implicitly creates an AnimationCollection from a ColorModifier 
Shares a Changed event handler with the current object's data 
members or removes it. Inherited from Changeable. 
Ensures that simple (non-Changeable) members are being accessed 
from a valid Ul context. This method should be called before any simple 
members are accessed. Inherited from Changeable. 

Determines whether the specified Object instances are the same 
instance. Inherited from Object. 

SetDefaultParentTimeline Inherited from Modifier. 

Returns a String that represents the current Object. Inherited from 
Object. 

Verifies that the current object has a valid state. If the object is in an 
invalid state, this method throws an exception. Inherited from 
Changeable. 

Causes the current object to validate itself and then invokes the 
OnChanged method. Inherited from Changeable. 

Ensures that simple (non-Changeable) members are being accessed 
from a valid user interface (Ul) context. This method should be called 
before any simple members are set. Inherited from Changeable. 



Property 



AllowChangeableReferenceOverride 



CanMakeUnchangeable 



Description 

Used in conjunction with the ChangeableUsageOverride type sent 
in as a parameter to ChangeableHelper.UseChangeable, to help 
determine when a Changeable being put into "use" should be 
promoted to "ChangeableReference". Inherited from Changeable. 

True if this Changeable can be made unchangeable. Inherited 
from Changeable. 
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IsChangeable 
IsChanging 

IsOverridingBaseValue 

StatusOfNextUse 

UlContext 
UsesBaseValue 



Gets a Boolean that indicates whether the object is currently 
modifiable. Inherited from Changeable. 

Gets a value that indicates whether the animation is 
active. Inherited from Modifier. 

Gets a value that indicates whether the animation is active or in a 
fill period. Inherited from Modifier. 

Gets or sets a UseStatus enumeration that specifies how the 
Changeable object behaves when it is "used." A Changeable 
object is considered used in the following situations: the object is 
set into a Property System property, the object is used as a sub- 
object in a complex Changeable object, or the object is used in a 
DrawingContext command. Inherited from Changeable. 
Gets the UlContext of the current object. The UlContext is used for 
maintaining thread safety. Inherited from Changeable. 
UsesBaseValue Inherited from Modifier. 



ColorTimedModifier Class 



Method 

Beginln 
CloneCore 

CloneDownToUnchangeable 

ColorTimedModifier 
Copy 
Copy 



Description 

Starts or restarts the animation at the specified offset from the current 
time. 

Returns a modifiable shallow or deep clone of the current object. This 
abstract method must be implemented by classes that derive from 
Changeable. Inherited from Changeable. 

Returns an immutable copy of the specified object. Inherited from 
Changeable. 



Creates a copy of this ColorTimedModifier 
Creates a copy of this ColorModifier Inherited from ColorModifier. 
Returns a modifiable copy of the current object. The copy's 
c °Py IsChangeable property is true and its StatusOfNextUse is 

Unchangeable. Inherited from Changeable. 

Disable Disables this timeline, after which the timeline can no longer become 

active. The timeline can be re-enabled with a call to Enable. 
Accesses the specified Changeable data member, processes it, and 
returns a reference to the member. This reference should then be 
EmbeddedChangeableReader reassigned to the original member variable. Classes that derive from 

Changeable call this method on data members before they can be 
retrieved through property calls. Inherited from Changeable. 
Processes a modified Changeable data member and returns a 
reference to the processed object. Inherited from Changeable. 
Enables this timeline, parenting it to the timeline specified by the 
ParentTimeline property. This allows the timeline to become active. This 
method throws an exception if the ParentTimeline property is null. 
Endln Schedules an interactive end time. 

Eq ua |s Determines whether two Object instances are equal. Inherited from 

Object. 



EmbeddedChangeableWriter 



Enable 



FilllnClone 
Finalize 



Allows an Object to attempt to free resources and perform other cleanup 
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GetHashCode 

GetType 
GetValue 
GetValuelmpI 
IModifier.GetValue 

MakeUnchangeable 

MakeUnchangeableCore 
MemberwiseClone 



ModifyHandlerlfChangeable 

OnChanged 

opjmplicit 
Pause 

PropagateEventHandler 
ReadPreamble 

ReferenceEquals 

Resume 

Seek 

SetDefaultParentTimeline 
ToString 

ValidateObjectState 
WritePostscript 

WritePreamble 



operations before the Object is reclaimed by garbage 
collection. Inherited from Object. 

Serves as a hash function for a particular type, suitable for use in 
hashing algorithms and data structures like a hash table. Inherited from 
Object. 

Gets the Type of the current instance. Inherited from Object. 
Inherited from ColorModifier. 
Inherited from ColorModifier. 
Inherited from Modifier. 

Makes an object immutable; after this method is called on a 
Changeable, its IsChangeable property is false. Inherited from 
Changeable. 

MakeUnchangeableCore Inherited from Modifier. 

Creates a shallow copy of the current Object. Inherited from Object. 

Adds or removes a Changed event handler to or from the specified 

Changeable object, if the object is currently modifiable. If the specified 

object is not modifiable— if its IsChangeable property is false— this 

method has no effect. Inherited from Changeable. 

Called when the current object is modified. Classes that derive from 

Changed should call this method after they have been 

modified. Inherited from Changeable. 

Implicitly creates an AnimationCollection from a ColorModifier Inherited 
from ColorModifier. 

Pauses this timeline. 

Ensures that simple (non-Changeable) members are being accessed 
from a valid user interface (Ul) context. This method should be called 
before any simple members are accessed. Inherited from Changeable. 
Determines whether the specified Object instances are the same 
instance. Inherited from Object. 

Resumes this timeline. 

Moves the current position of the animation backwards or forwards from 
either the current time, the Begin time, or the End time. 

SetDefaultParentTimeline Inherited from Modifier. 

Returns a String that represents the current Object. Inherited from 
Object. 

Verifies that the current object has a valid state. If the object is in an 
invalid state, this method throws an exception. Inherited from 
Changeable. 

Causes the current object to validate itself and then invokes the 
OnChanged method. Inherited from Changeable. 

Ensures that simple (non-Changeable) members are being accessed 
from a valid Ul context. This method should be called before any simple 
members are set. Inherited from Changeable. 



Property 



Description 

Gets or sets the fraction of the simple duration spent in the 
acceleration phase. 

AllowChangeableReferenceOverride Used in conjunction with the ChangeableUsageOverride type sent in 



Acceleration 
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Auto Reverse 
Begin 

CanMakeUnchangeable 

CurrentRepeat 
CurrentTime 

Deceleration 

Duration 
End 

EndSync 
Fill 

FillDefault 

IsChangeable 

IsChanging 
IsEnabled 

IsForwardProgressing 

IsOverridingBaseValue 

IsPaused 

IsReversed 
ParentTimeline 
Progress 
RepeatCount 

RepeatDuration 
Restart 

RestartDefault 
Speed 



as a parameter to ChangeableHelper.UseChangeable, to help 
determine when a Changeable being put into "use" should be 
promoted to "ChangeableReference". Inherited from Changeable. 
Gets or sets a value that indicates whether the animation plays in 
reverse after it completes its forward iteration. 
Gets or sets an offset to the start time of the animation. 

True if this Changeable can be made unchangeable. Inherited from 
Changeable. 

Gets the number of the current iteration of the animation. 

Gets the current time value of the animation. 

Gets or sets a value that represents the fraction of the simple 
duration spent in the deceleration phase. 

Gets or sets the length of time the animation takes to complete a 
single forward iteration, also known as the simple duration of an 
animation. 

Gets or sets the maximum end time of the animation. 
Gets or sets a TimeEndSync enumeration that specifies how the 
implicit duration of an animation is determined. This property is only 
used if the Duration property is not explicitly set. 

Gets or sets a value that specifies the state of an object when its 
animation ends. 

Gets or sets a value that indicates the default value of the Fill 
property of the current animation and its child timelines. 
Gets a Boolean that indicates whether the object is currently 
modifiable. Inherited from Changeable. 
Gets a value that indicates whether the animation is active. 

Gets a value that indicates whether the animation is progressing 
from past to future. 

Gets a value that indicates whether the animation is active or in a fill 
period. 

Gets a value that indicates whether the animation is active and 
paused. 

Gets a value that indicates whether the animation is currently 
moving in the opposite direction of its parent timeline. 
Gets or sets the default parent timeline of the animation. 

Gets a number from 0 to 1 that indicates the fraction of the simple 
duration that has elapsed. 

Gets or sets the number of times an animation should repeat. 
Gets or sets the total length of time the animation should play. If this 
value is greater than the simple duration of the animation, it will 
repeat itself for the length of time specified by this property. 
Gets or sets the animation's behavior when it is told to restart— that 
is, how the animation behaves when a second begin time is 
reached. 

Gets or sets the default value of the Restart property of the current 
animation and its child timelines. 

Gets or sets the relative speed at which time should pass for the 
animation, compared to its parent timeline. 
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StatusOfNextUse 

Timeline 

UlContext 

UsesBaseValue 



Gets or sets a UseStatus enumeration that specifies how the 
Changeable object behaves when it is "used." A Changeable object 
is considered used in the following situations: the object is set into a 
Property System property, the object is used as a sub-object in a 
complex Changeable object, or the object is used in a 
DrawingContext command. Inherited from Changeable. 
Timeline 

Gets the UlContext of the current object. The UlContext is used for 
maintaining thread safety. Inherited from Changeable. 
UsesBaseValue Inherited from Modifier. 



DecimalAnimationCollection Class 

Definitions: Represents a collection of DecimalModifier animations. 



Method 

Add 

AddChild 

AddText 

Apply 

Clear 
CloneCore 

CloneDownToUnchangeable 

Contains 
Copy 

Copy 
CopyTo 

DecimalAnimationCollection 

Disable 
Disablelmpl 

EmbeddedChangeableReader 

EmbeddedChangeableWriter 

Enable 
Enablelmpl 



Description 

The Add(DecimalModifier) and Add(Object) methods add animations to 
the collection; the Add(Decimal, DecimalAnimationCollection) method 
calculates the current value of the specified collection based on the 
specified base value. 

Implementation of AddChild. Adds a Modifier to this AnimationCollection 
from Markup. 

Implementation of AddText. This is not implemented on this class. 

Implementation of Apply. Applies an animation collection in markup to 
an element. 

Clears the collection by setting the collection's Count to 0. 
CloneCore 

Returns an immutable copy of the specified object. Inherited from 
Changeable. 

Returns a Boolean that indicates whether the collection contains the 
specified DecimalModifier. 

Creates a copy of this DecimalAnimationCollection. 
Returns a modifiable copy of the current object. The copy's 
IsChangeable property is true and its StatusOfNextUse is 
Unchangeable. Inherited from Changeable. 
Copies the entire DecimalAnimationCollection to the specified one- 
dimensional array, starting at the specified index of the target array. 

Creates an empty DecimalAnimationCollection with a default capacity 
for a single animation. 

Inherited from AnimationCollection. 

Accesses the specified Changeable data member, processes it, and 
returns a reference to the member. This reference should then be 
reassigned to the original member variable. Classes that derive from 
Changeable call this method on data members before they can be 
retrieved through property calls. Inherited from Changeable. 
Processes a modified Changeable data member and returns a reference 
to the processed object. Inherited from Changeable. 
Inherited from AnimationCollection. 
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Equals 
Finalize 

GetEnumerator 
GetEnumeratorlmpI 

GetHashCode 

GetType 

GetValue 

GetValuelmpI 

IndexOf 

Insert 

MakeUnchangeable 

MakeUnchangeableCore 
MemberwiseClone 

ModifyHandlerlfChangeable 

OnChanged 
op_Addition 
opjmplicit 

PropagateEventHandler 
ReadPreamble 

ReferenceEquals 

Remove 
RemoveAt 

SetDefaultParentTimeline 
SetValuelmpI 

ToString 

ValidateObjectState 
WritePostscript 

WritePreamble 



Determines whether two Object instances are equal. Inherited from 
Object. 

Allows an Object to attempt to free resources and perform other cleanup 
operations before the Object is reclaimed by garbage 
collection. Inherited from Object. 

GetEnumerator Inherited from AnimationCollection. 

Returns an object that can be used to enumerate items in the list. 

Serves as a hash function for a particular type, suitable for use in 

hashing algorithms and data structures like a hash table. Inherited from 

Object. 

Gets the Type of the current instance. Inherited from Object. 
Returns the current value of the animation. 
Provides a Modifier at a given index. 



Makes an object immutable; after this method is called on a 
Changeable, its IsChangeable property is false. Inherited from 
Changeable. 

Implementation of MakeUnchangeableCore. 

Creates a shallow copy of the current Object. Inherited from Object. 

Adds or removes a Changed event handler to or from the specified 

Changeable object, if the object is currently modifiable. If the specified 

object is not modifiable— if its IsChangeable property is false— this 

method has no effect. Inherited from Changeable. 

OnChanged 



Implementation of PropagateEventHandler. 

Ensures that simple (non-Changeable) members are being accessed 
from a valid Ul context. This method should be called before any simple 
members are accessed. Inherited from Changeable. 

Determines whether the specified Object instances are the same 
instance. Inherited from Object. 



Inherited from AnimationCollection. 
Sets a Modifier at a given index. 

Returns a String that represents the current Object. Inherited from 
Object. 

Verifies that the current object has a valid state. If the object is in an 
invalid state, this method throws an exception. Inherited from 
Changeable. 

Causes the current object to validate itself and then invokes the 
OnChanged method. Inherited from Changeable. 
Ensures that simple (non-Changeable) members are being accessed 
from a valid user interface (Ul) context. This method should be called 
before any simple members are set. Inherited from Changeable. 
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V 



Property Descripti n 

Used in conjunction with the ChangeableUsageOverride type sent in 

AllowChangeableReferenceOverride as a P arameter t0 ChangeableHelper.UseChangeable, to help 

determine when a Changeable being put into "use" should be 
promoted to "ChangeableReference". Inherited from Changeable. 
AnimationType 

True if this Changeable can be made unchangeable. Inherited from 
Changeable. 

Inherited from AnimationCollection. 



An unchangeable empty DecimalAnimationCollection. 
Gets a Boolean that indicates whether the object is currently 
modifiable. Inherited from Changeable. 

Returns true if at least one of the animations in the animation list is 
currently active. Inherited from AnimationCollection. 

Returns true if at least one of the animations in the animation list is 
currently on. Inherited from AnimationCollection. 



Inherited from AnimationCollection. 



this - typed version of indexer 

Use this to get or set a Modifier at a given index. Inherited from 
AnimationCollection. 

Gets or sets a UseStatus enumeration that specifies how the 
Changeable object behaves when it is "used." A Changeable object 
is considered used in the following situations: the object is set into a 
Property System property, the object is used as a sub-object in a 
complex Changeable object, or the object is used in a 
DrawingContext command. Inherited from Changeable. 

Gets the UlContext of the current object. The UlContext is used for 
maintaining thread safety. Inherited from Changeable. 

The AnimationCollection classes, such as DecimalAnimationCollection, provide you with more control 
over how you animate a property than a single animation could. Each of the AnimationCollection classes 
effectively functions as a single composite animation, using all the animations in the collection to animate 
a base value. When a property requests the current value of an DecimalAnimationCollection, the property 
calls the DecimalAnimationCollection's GetValue method and passes it the property's base value. The 
first animation in the collection processes this base value and produces a result, which is then passed to 
the next animation in the collection, and so on, until the value has been processed by all the animations in 
the collection. 

This example demonstrates how to animate a property using "Longhorn" markup language (code-named 
"XAML"). To animate a property, you associate the proper animation collection and animations with the 
property either directly or using the property's corresponding animation property. There are a variety of 
animation classes, each of which animates a different kind of value. 



AnimationType 

CanMakeUnchangeable 

Count 
Countlmpl 
Empty 

IsChangeable 

IsChanging 

IsFixedSize 

IsOverridingBaseValue 

IsReadOnly 
IsSynchronized 
IsUsingBaseValue 
IsUsingBaseValuelmpI 
Item 

Item 

StatusOfNextUse 

SyncRoot 
UlContext 
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Before some properties can be animated, they must be given a base value. For example, before 
animating the RectangieWidth of a Rectangle, the RectangleWidth must be set to a non-animated value 
(in this case, a Length object). 

In the following example, the Width of a Button is animated. Because the Width property takes a Length, 
a LengthAnimation is needed. A LengthAnimationCollection is used to contain the LengthAnimation. 
Although in this example there is only one animation, you could associate multiple animations with a 
single property by placing the animations within the collection. Because there is no WidthAnimations 
property, the LengthAnimationCollection is associated directly with the button's Width property. 

<Canvas ID="root" 
xmlns= , 'http://schemas.microsoft.com/2003/xaml"> 

<Button Canvas.Top="20" Canvas. Left="20" 
Height="30 M Width="200"> 

< Button. Width> 
<LengthAnimationCollection> 

<LengthAnimation To="50" Duration="5" RepeatCount="500" 
AutoReverse="True7> 
</LengthAnimationCollection> 
</Button.Width> 

A Button 
</Button> 

In the next example, the Background color of a second button is animated. The Background property 
takes a Brush. In this example, a SolidColorBrush is used to fill the button's Background, although a 
gradient, image, or pattern could have been used. To animate the button's background color, the Color of 
the SolidColorBrush must be animated. Because the SolidColorBrush.Color property accepts a Color, a 
ColorAnimation is used to animate the property. The SolidColorBrush.Color property has a corresponding 
ColorAnimations property, so the ColorAnimation is nested within the ColorAnimations property in order 
to animate the color of the brush. 

<Button Canvas.Top="70" Canvas. Left="20" 
Height="30" Width="200"> 

<Button.Background> 
<SolidColorBrush Color="Blue"> 
<SolidColorBrush.ColorAnimations> 
<ColorAnimation From="Red" To="Blue" Duration="7" 
RepeatCount="500" AutoReverse="True7> 
</SolidColorBrush.ColorAnimations> 
</SolidColorBrush> 
</Button.Background> 

Another Button 
</Button> 

</Canvas> 

In the previous example, the ColorAnimationCollection tag, <ColorAnimationCollection> is omitted when 
animating the brush's color. When animating a designated animation property— properties of the form 
PropertyNameAnimations, such as the ColorAnimations property in the previous example — you may omit 
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the animation collection tag. However, when animating a property of a Ul element— those classes that 
derive from UlElement— you must nest the animations within an animation collection tag. 



DecimalM difier Class 



Method 

CloneCore 

CloneDownToUnchangeable 
Copy 

Copy 

DecimalModifier 



Description 

Returns a modifiable shallow or deep clone of the current object. This 
abstract method must be implemented by classes that derive from 
Changeable. Inherited from Changeable. 

Returns an immutable copy of the specified object. Inherited from 
Changeable. 

Creates a copy of this DecimalModifier 

Returns a modifiable copy of the current object. The copy's 
IsChangeable property is true and its StatusOfNextUse is 
Unchangeable. Inherited from Changeable. 



Accesses the specified Changeable data member, processes it, and 
returns a reference to the member. This reference should then be 
EmbeddedChangeableReader reassigned to the original member variable. Classes that derive from 

Changeable call this method on data members before they can be 
retrieved through property calls. Inherited from Changeable. 
Processes a modified Changeable data member and returns a 
reference to the processed object. Inherited from Changeable. 

Determines whether two Object instances are equal. Inherited from 
Object. 

Allows an Object to attempt to free resources and perform other cleanup 
operations before the Object is reclaimed by garbage 
collection. Inherited from Object. 

Serves as a hash function for a particular type, suitable for use in 
hashing algorithms and data structures like a hash table. Inherited from 
Object. 

Gets the Type of the current instance. Inherited from Object. 



EmbeddedChangeableWriter 
Equals 

Finalize 
GetHashCode 



GetType 
GetValue 



GetValuelmpI 
IModifier.GetValue 

MakeUnchangeable 

MakeUnchangeableCore 
MemberwiseClone 

ModifyHandlerlfChangeable 



OnChanged 
opjmplicit 

PropagateEventHandler 



Inherited from Modifier. 

Makes an object immutable; after this method is called on a 
Changeable, its IsChangeable property is false. Inherited from 
Changeable. 

MakeUnchangeableCore Inherited from Modifier. 

Creates a shallow copy of the current Object. Inherited from Object. 

Adds or removes a Changed event handler to or from the specified 

Changeable object, if the object is currently modifiable. If the specified 

object is not modifiable— if its IsChangeable property is false— this 

method has no effect. Inherited from Changeable. 

Called when the current object is modified. Classes that derive from 

Changed should call this method after they have been 

modified. Inherited from Changeable. 

Implicitly creates an AnimationCollection from a DecimalModifier 
Shares a Changed event handler with the current object's data 
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Read Preamble 

ReferenceEquals 

SetDefaultParentTimeline 

ToString 

ValidateObjectState 
WritePostscript 

WritePreamble 

Property 



members or removes it. Inherited from Changeable. 

Ensures that simple (non-Changeable) members are being accessed 
from a valid Ul context. This method should be called before any simple 
members are accessed. Inherited from Changeable. 

Determines whether the specified Object instances are the same 
instance. Inherited from Object. 

SetDefaultParentTimeline Inherited from Modifier. 

Returns a String that represents the current Object. Inherited from 
Object. 

Verifies that the current object has a valid state. If the object is in an 
invalid state, this method throws an exception. Inherited from 
Changeable. 

Causes the current object to validate itself and then invokes the 
OnChanged method. Inherited from Changeable. 

Ensures that simple (non-Changeable) members are being accessed 
from a valid user interface (Ul) context. This method should be called 
before any simple members are set. Inherited from Changeable. 



Description 

Used in conjunction with the ChangeableUsageOverride type sent in 

AllowChangeableReferenceOverride ^ s . a P arame t erto ChangeableHelper.UseChangeable, to help 

determine when a Changeable being put into "use" should be 
promoted to "ChangeableReference". Inherited from Changeable. 

True if this Changeable can be made unchangeable. Inherited from 
Changeable. 

Gets a Boolean that indicates whether the object is currently 
modifiable. Inherited from Changeable. 

Gets a value that indicates whether the animation is active. Inherited 
from Modifier. 



CanMakeUnchangeable 

IsChangeable 

IsChanging 



IsOverridingBaseValue 

StatusOfNextUse 

UlContext 
UsesBaseValue 



Gets a value that indicates whether the animation is active or in a fill 
period. Inherited from Modifier. 

Gets or sets a UseStatus enumeration that specifies how the 
Changeable object behaves when it is "used." A Changeable object 
is considered used in the following situations: the object is set into a 
Property System property, the object is used as a sub-object in a 
complex Changeable object, or the object is used in a 
DrawingContext command. Inherited from Changeable. 

Gets the UlContext of the current object. The UlContext is used for 
maintaining thread safety. Inherited from Changeable. 

UsesBaseValue Inherited from Modifier. 



DecimalTimedModifier Class 



Method 



Beginln 



CloneCore 



Description 

Starts or restarts the animation at the specified offset from the current 
time. 

Returns a modifiable shallow or deep clone of the current object. This 
abstract method must be implemented by classes that derive from 
Changeable. Inherited from Changeable. 
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CloneDownToUnchangeable 
Copy 

Copy 

Copy 

DecimalTimedModifier 
Disable 



Returns an immutable copy of the specified object. Inherited from 
Changeable. 

Creates a copy of this DecimalModifier Inherited from DecimalModifier. 
Returns a modifiable copy of the current object. The copy's 
IsChangeable property is true and its StatusOfNextUse is 
Unchangeable. Inherited from Changeable. 

Creates a copy of this DecimalTimedModifier 

Disables this timeline, after which the timeline can no longer become 
active. The timeline can be re-enabled with a call to Enable. 

Accesses the specified Changeable data member, processes it, and 
returns a reference to the member. This reference should then be 
EmbeddedChangeableReader reassigned to the original member variable. Classes that derive from 

Changeable call this method on data members before they can be 
retrieved through property calls. Inherited from Changeable. 
Processes a modified Changeable data member and returns a 
reference to the processed object. Inherited from Changeable. 
Enables this timeline, parenting it to the timeline specified by the 
ParentTimeline property. This allows the timeline to become active. This 
method throws an exception if the ParentTimeline property is null. 
Schedules an interactive end time. 



EmbeddedChangeableWriter 



Enable 



Endln 
Equals 
FilllnClone 

Finalize 

GetHashCode 

GetType 
GetValue 
GetValuelmpI 
IModifier.GetValue 

MakeUnchangeable 

MakeUnchangeableCore 
MemberwiseClone 

ModifyHandlerlfChangeable 

OnChanged 

opjmplicit 
Pause 



Determines whether two Object instances are equal. Inherited from 
Object. 

Allows an Object to attempt to free resources and perform other cleanup 
operations before the Object is reclaimed by garbage 
collection. Inherited from Object. 

Serves as a hash function for a particular type, suitable for use in 
hashing algorithms and data structures like a hash table. Inherited from 
Object. 

Gets the Type of the current instance. Inherited from Object. 
Inherited from DecimalModifier. 
Inherited from DecimalModifier. 
Inherited from Modifier. 

Makes an object immutable; after this method is called on a 
Changeable, its IsChangeable property is false. Inherited from 
Changeable. 

MakeUnchangeableCore Inherited from Modifier. 
Creates a shallow copy of the current Object. Inherited from Object. 
Adds or removes a Changed event handler to or from the specified 
Changeable object, if the object is currently modifiable. If the specified 
object is not modifiable— if its IsChangeable property is false— this 
method has no effect. Inherited from Changeable. 

Called when the current object is modified. Classes that derive from 
Changed should call this method after they have been 
modified. Inherited from Changeable. 
Implicitly creates an AnimationCollection from a 
DecimalModifier Inherited from DecimalModifier. 
Pauses this timeline. 
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PropagateEventHandler 
ReadPreamble 

ReferenceEquals 

Resume 

Seek 

SetDefaultParentTimeline 
ToString 

ValidateObjectState 
WritePostscript 

WritePreamble 



Ensures that simple (non-Changeable) members are being accessed 
from a valid user interface (Ul) context. This method should be called 
before any simple members are accessed. Inherited from Changeable. 

Determines whether the specified Object instances are the same 
instance. Inherited from Object. 

Resumes this timeline. 

Moves the current position of the animation backwards or forwards from 
either the current time, the Begin time, or the End time. 

SetDefaultParentTimeline Inherited from Modifier. 

Returns a String that represents the current Object. Inherited from 
Object. 

Verifies that the current object has a valid state. If the object is in an 
invalid state, this method throws an exception. Inherited from 
Changeable. 

Causes the current object to validate itself and then invokes the 
OnChanged method. Inherited from Changeable. 

Ensures that simple (non-Changeable) members are being accessed 
from a valid Ul context. This method should be called before any simple 
members are set. Inherited from Changeable. 



Property 



Acceleration 



AllowChangeableReferenceOverride 

AutoReverse 
Begin 

CanMakeUnchangeable 

CurrentRepeat 
CurrentTime 

Deceleration 

Duration 
End 

EndSync 
Fill 

FillDefault 
IsChangeable 



Description 

Gets or sets the fraction of the simple duration spent in the 
acceleration phase. 

Used in conjunction with the ChangeableUsageOverride type sent 
in as a parameter to ChangeableHelper.UseChangeable, to help 
determine when a Changeable being put into "use" should be 
promoted to "ChangeableReference". Inherited from Changeable. 

Gets or sets a value that indicates whether the animation plays in 
reverse after it completes its forward iteration. 

Gets or sets an offset to the start time of the animation. 

True if this Changeable can be made unchangeable. Inherited 
from Changeable. 

Gets the number of the current iteration of the animation. 

Gets the current time value of the animation. 

Gets or sets a value that represents the fraction of the simple 
duration spent in the deceleration phase. 

Gets or sets the length of time the animation takes to complete a 
single forward iteration, also known as the simple duration of an 
animation. 

Gets or sets the maximum end time of the animation. 

Gets or sets a TimeEndSync enumeration that specifies how the 
implicit duration of an animation is determined. This property is 
only used if the Duration property is not explicitly set. 

Gets or sets a value that specifies the state of an object when its 
animation ends. 

Gets or sets a value that indicates the default value of the Fill 
property of the current animation and its child timelines. 

Gets a Boolean that indicates whether the object is currently 
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IsChanging 
IsEnabled 

IsForwardProgressing 

IsOverridingBaseValue 

IsPaused 

IsReversed 

ParentTimeline 

Progress 

RepeatCount 
RepeatDuration 

Restart 

RestartDefault 
Speed 

StatusOfNextUse 

Timeline 

UlContext 

UsesBaseValue 



modifiable. Inherited from Changeable. 

Gets a value that indicates whether the animation is active. 

Gets a value that indicates whether the animation is progressing 
from past to future. 

Gets a value that indicates whether the animation is active or in a 
fill period. 

Gets a value that indicates whether the animation is active and 
paused. 

Gets a value that indicates whether the animation is currently 
moving in the opposite direction of its parent timeline. 

Gets or sets the default parent timeline of the animation. 

Gets a number from 0 to 1 that indicates the fraction of the simple 
duration that has elapsed. 

Gets or sets the number of times an animation should repeat. 

Gets or sets the animation's behavior when it is told to restart- 
that is, how the animation behaves when a second begin time is 
reached. 

Gets or sets the default value of the Restart property of the current 
animation and its child timelines. 

Gets or sets the relative speed at which time should pass for the 
animation, compared to its parent timeline. 

Gets or sets a UseStatus enumeration that specifies how the 
Changeable object behaves when it is "used." A Changeable 
object is considered used in the following situations: the object is 
set into a Property System property, the object is used as a sub- 
object in a complex Changeable object, or the object is used in a 
DrawingContext command. Inherited from Changeable. 

Timeline 

Gets the UlContext of the current object. The UlContext is used for 
maintaining thread safety. Inherited from Changeable. 

UsesBaseValue Inherited from Modifier. 



DoubleAnimation Class 



Method 

Beginln 
CloneCore 

CloneDownToUnchangeable 

Copy 
Copy 

Copy 



Description 

Starts or restarts the animation at the specified offset from the current 
time. Inherited from DoubleTimedModifier. 

Implementation of CloneCore. 

Returns an immutable copy of the specified object. Inherited from 
Changeable. 

Creates a copy of this DoubleTimedModifier Inherited from 
DoubleTimedModifier. 

Creates a copy of this DoubleModifier Inherited from DoubleModifier. 

Returns a modifiable copy of the current object. The copy's 
IsChangeable property is true and its StatusOfNextUse is 
Unchangeable. Inherited from Changeable. 
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Disable 



DoubleAnimation 



Disables this timeline, after which the timeline can no longer become 
active. The timeline can be re-enabled with a call to Enable. Inherited 
from DoubleTimedModifier. 

Initializes a new instance of the DoubleAnimation class. 



Accesses the specified Changeable data member, processes it, and 
returns a reference to the member. This reference should then be 
EmbeddedChangeableReader reassigned to the original member variable. Classes that derive from 

Changeable call this method on data members before they can be 
retrieved through property calls. Inherited from Changeable. 

Processes a modified Changeable data member and returns a 
reference to the processed object. Inherited from Changeable. 

Enables this timeline, parenting it to the timeline specified by the 
ParentTimeline property. This allows the timeline to become active. This 
method throws an exception if the ParentTimeline property is 
null. Inherited from DoubleTimedModifier. 



EmbeddedChangeableWriter 



Enable 



Endln 

Equals 

FilllnClone 

Finalize 

GetHashCode 

GetType 
GetValue 
GetValuelmpI 
IModifier.GetValue 

MakeUnchangeable 

MakeUnchangeableCore 
MemberwiseClone 

ModifyHandlerlfChangeable 

OnChanged 

opjmplicit 
Pause 

PropagateEventHandler 
ReadPreamble 

ReferenceEquals 



Schedules an interactive end time. Inherited from DoubleTimedModifier. 

Determines whether two Object instances are equal. Inherited from 
Object. 

Inherited from DoubleTimedModifier. 

Allows an Object to attempt to free resources and perform other cleanup 
operations before the Object is reclaimed by garbage 
collection. Inherited from Object. 

Serves as a hash function for a particular type, suitable for use in 
hashing algorithms and data structures like a hash table. Inherited from 
Object. 

Gets the Type of the current instance. Inherited from Object. 
Calculates the value of the animation at the current time. 

Inherited from DoubleModifier. 

Inherited from Modifier. 

Makes an object immutable; after this method is called on a 
Changeable, its IsChangeabie property is false. Inherited from 
Changeable. 

MakeUnchangeableCore Inherited from Modifier. 
Creates a shallow copy of the current Object. Inherited from Object. 
Adds or removes a Changed event handler to or from the specified 
Changeable object, if the object is currently modifiable. If the specified 
object is not modifiable — if its IsChangeabie property is false — this 
method has no effect. Inherited from Changeable. 

Called when the current object is modified. Classes that derive from 
Changed should call this method after they have been 
modified. Inherited from Changeable. 

Implicitly creates an AnimationCollection from a 
DoubleModifier Inherited from DoubleModifier. 

Pauses this timeline. Inherited from DoubleTimedModifier. 

PropagateEventHandler 

Ensures that simple (non-Changeable) members are being accessed 
from a valid Ul context. This method should be called before any simple 
members are accessed. Inherited from Changeable. 

Determines whether the specified Object instances are the same 
instance. Inherited from Object. 
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Resume 
Seek 

SetDefaultParentTimeline 
ToString 

ValidateObjectState 
WritePostscript 

WritePreamble 



Resumes this timeline. Inherited from DoubleTimedModifier. 

Moves the current position of the animation backwards or forwards from 
either the current time, the Begin time, or the End time. Inherited from 
DoubleTimedModifier. 

Returns a String that represents the current Object. Inherited from 
Object. 

Verifies that the current object has a valid state. If the object is in an 
invalid state, this method throws an exception. Inherited from 
Changeable. 

Causes the current object to validate itself and then invokes the 
OnChanged method. Inherited from Changeable. 

Ensures that simple (non-Changeable) members are being accessed 
from a valid user interface (Ul) context. This method should be called 
before any simple members are set. Inherited from Changeable. 



Property 



Acceleration 



AllowChangeableReferenceOverride 

AutoReverse 

Begin 
By 

CanMakeUnchangeable 

CurrentRepeat 

CurrentTime 

Deceleration 

Duration 
End 

EndSync 
Fill 



Description 

Gets or sets the fraction of the simple duration spent in the 
acceleration phase. Inherited from DoubleTimedModifier. 
Used in conjunction with the ChangeableUsageOverride type sent 
in as a parameter to ChangeableHelper.UseChangeable, to help 
determine when a Changeable being put into "use" should be 
promoted to "ChangeableReference". Inherited from Changeable. 
Gets or sets a value that indicates whether the animation plays in 
reverse after it completes its forward iteration. Inherited from 
DoubleTimedModifier. 

Gets or sets an offset to the start time of the animation. Inherited 
from DoubleTimedModifier. 

Gets or sets the total amount by which the animation changes its 
starting value. 

True if this Changeable can be made unchangeable. Inherited 
from Changeable. 

Gets the number of the current iteration of the animation. Inherited 
from DoubleTimedModifier. 

Gets the current time value of the animation. Inherited from 
DoubleTimedModifier. 

Gets or sets a value that represents the fraction of the simple 
duration spent in the deceleration phase. Inherited from 
DoubleTimedModifier. 

Gets or sets the length of time the animation takes to complete a 
single forward iteration, also known as the simple duration of an 
animation. Inherited from DoubleTimedModifier. 

Gets or sets the maximum end time of the animation. Inherited 
from DoubleTimedModifier. 

Gets or sets a TimeEndSync enumeration that specifies how the 
implicit duration of an animation is determined. This property is 
only used if the Duration property is not explicitly set. Inherited 
from DoubleTimedModifier. 

Gets or sets a value that specifies the state of an object when its 
animation ends. Inherited from DoubleTimedModifier. 
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FillDefault 
From 

InterpolationMethod 
IsAdditive 

IsChangeable 

IsChanging 

IsCumulative 
IsEnabled 

IsForwardProgressing 

IsOverridingBaseValue 

IsPaused 

IsReversed 

KeyFrames 
ParentTimeline 

Progress 

RepeatCount 

RepeatDuration 
Restart 

RestartDefault 
Speed 

StatusOfNextUse 



Timeline 
To 

UlContext 



Gets or sets a value that indicates the default value of the Fill 
property of the current animation and its child timelines. Inherited 
from DoubleTimedModifier. 

Gets or sets the starting value of an animation. 

InterpolationMethod 

IsAdditive 

Gets a Boolean that indicates whether the object is currently 
modifiable. Inherited from Changeable. 

Gets a value that indicates whether the animation is 
active. Inherited from DoubleTimedModifier. 
IsCumulative 

Inherited from DoubleTimedModifier. 

Gets a value that indicates whether the animation is progressing 

from past to future. Inherited from DoubleTimedModifier. 

Gets a value that indicates whether the animation is active or in a 

fill period. Inherited from DoubleTimedModifier. 

Gets a value that indicates whether the animation is active and 

paused. Inherited from DoubleTimedModifier. 

Gets a value that indicates whether the animation is currently 

moving in the opposite direction of its parent timeline. Inherited 

from DoubleTimedModifier. 

KeyValues 

Gets or sets the default parent timeline of the animation. Inherited 
from DoubleTimedModifier. 

Gets a number from 0 to 1 that indicates the fraction of the simple 
duration that has elapsed. Inherited from DoubleTimedModifier. 
Gets or sets the number of times an animation should 
repeat. Inherited from DoubleTimedModifier. 
Gets or sets the total length of time the animation should play. If 
this value is greater than the simple duration of the animation, it 
will repeat itself for the length of time specified by this 
property. Inherited from DoubleTimedModifier. 
Gets or sets the animation's behavior when it is told to restart- 
that is, how the animation behaves when a second begin time is 
reached. Inherited from DoubleTimedModifier. 
Gets or sets the default value of the Restart property of the current 
animation and its child timelines. Inherited from 
DoubleTimedModifier. 

Gets or sets the relative speed at which time should pass for the 
animation, compared to its parent timeline. Inherited from 
DoubleTimedModifier. 

Gets or sets a UseStatus enumeration that specifies how the 
Changeable object behaves when it is "used." A Changeable 
object is considered used in the following situations: the object is 
set into a Property System property, the object is used as a sub- 
object in a complex Changeable object, or the object is used in a 
DrawingContext command. Inherited from Changeable. 
Timeline Inherited from DoubleTimedModifier. 
Gets or sets the ending value of the animation. 
Gets the UlContext of the current object. The UlContext is used for 
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maintaining thread safety. Inherited from Changeable. 

UsesBaseValue 

This example demonstrates how to animate the size of an element using "Longhorn" markup language 
(code-named "XAML"). There are multiple ways to animate the size of an element: directly animate the 
height and width attributes of the element, or apply an animated ScaleTransform to the element. In this 
example, two Rectangle elements are resized using these methods. One rectangle is resized by 
animating its RectangleWidth attribute and another is resized by animating a ScaleTransform applied to 
the rectangle. Each rectangle is filled with a pattern to highlight the differences between the two resizing 
methods. Initially, the two patterns look the same, but as the rectangles are resized, patterns change 
depending on how their containing rectangle is resized. 

In the first example, a Rectangle element's RectangleWidth property is animated using a 
LengthAnimationCollection and a LengthAnimation. The LengthAnimation object in this example animates 
the rectangle's RectangleWidth from its base value of 200 To a destination value of 600 over a Duration 
of 10 seconds. 

<Canvas ID= M root" 

xmlns="http://schemas.microsoft.com/2003/xamr , > 

<Rectangle 
RectangleTop= H 20 n 
RectangleLeft="20" 
RectangleWidth="200" 
RectangleHeight="150 M 
Stroke="Red" 
StrokeThickness="5"> 

<Rectangle.Fill> 

<lmageBrush ViewPort="0,0 100,100" ViewPortUnits= M Absolute M 
lmageSource="help.gif' TileMode='Tile7> 
</Rectangle.Fill> 

<Rectangle.RectangleWidth> 
<!-- Animate the Rectangle's width: --> 
<LengthAnimationCollection> 
<LengthAnimation 

To="600" Durational 0" AutoReverse="true" RepeatCount="50" /> 
</LengthAnimationCollection> 
</Rectangle.RectangleWidth> 

</Rectangle> 



When the previous "XAML" is run, more of the pattern is exposed as the rectangle expands; however the 
question marks that make up the pattern do not grow larger. 

In the next example, a TransformDecorator is used to apply a ScaleTransform to a rectangle. A 
DoubleAnimation is used to animate the ScaleTransform object's ScaleX value using the 
ScaleXAnimations attribute. The DoubleAnimation animates the ScaleX value From 1 To a destination 
value of 3 over a Duration of 10 seconds. As a result, the rectangle's width is scaled from 100 percent (its 
starting size) to 300 percent over ten seconds. 

<TransformDecorator AffectsLayout="False"> 
<TransformDecorator.Transform> 
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<!-- Use the ScaleTransform to enlarge the rectangle -> 
<ScaleTransform ScaleX= M 1" ScaleY='T'> 
<ScaleTransform.ScaleXAnimations> 
<DoubleAnimation From='T' To="3" RepeatCount="30" 
AutoReverse="True" Begin="0" Durational 0" /> 
</ScaleTransform.ScaleXAnimations> 
</ScaleTransform> 

</TransformDecorator.Transform> 

<Rectangle 
RectangleLeft="20" 
RectangleTop="200" 
RectangleWidth="200" 
RectangleHeight="150" 
Stroke="Black M 
StrokeThickness="3"> 
<Rectangle.Fill> 

<lmageBrush ViewPort="0,0 100,100" ViewPortUnits= n Absolute" 
lmageSource="help.gif TileMode= , Tile , 7> 
</Rectangle.Fill> 
</Rectangle> 
</TransformDecorator> 

</Canvas> 

In the previous example, the DoubleAnimationCollection tag, <DoubleAnimationCollection>, is omitted 
when animating the transformation's scale factor. When animating a designated animation property- 
properties of the form PropertyNameAnimations, such as the ScaleXAnimations property in the previous 
example— you may omit the animation collection tag. However, when animating a property of a Ul 
element— those classes that derive from UlElement— you must nest the animations within an animation 
collection tag. 

When the second rectangle expands, the objects in the pattern also grow larger, unlike in the first 
rectangle. The pattern behaves this way because when you transform an element the entire element and 
its child elements are transformed. When you directly alter the size of an element, as in the case of the 
first rectangle, the element's children are not resized, unless their size and position are dependent on the 
size of their parent element. 

This example demonstrates how to use the By, From, and To properties of animations to set an 
animation's starting and ending values in "XAML". In the following markup, LengthAnimation objects are 
used to animate the endpoints of five Line elements. Although this example uses the LengthAnimation, 
the behavior of the From, To, and By properties is the same for all the animation classes. 
In the first markup fragment, the X2 attribute of the first line is animated from 50 to 100 over a duration of 
10 seconds. Because the From and To properties of the LengthAnimation are set, the animation ignores 
the line's base value, starting at the specified From value and moving toward the specified To value. 

<Canvas ID="root" 
xmlns="http://schemas.microsoft.com/2003/xaml"> 

<Line ID="Line1" X1="10" Y1="10" X2="100" Y2="50" 
Stroke="Black" StrokeThickness="5"> 
<Line.X2> 
<LengthAnimationCollection> 

<LengthAnimation From="50" To="300" Durational 0" RepeatCount="50" /> 
</LengthAnimationCollection> 
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</Line.X2> 
</Line> 



The second line's animation has only its To property set. When the From value of an animation isn't set, 
the animation uses the base value of the property it is animating or the ending value of a previous 
animation. In this example, the animation uses the base value of the line's X2 property, 100, as its starting 
value. 

<Line ID="Line2" X1="10" Y1="70" X2="100" Y2="70" Stroke="Black" StrokeThickness="5"> 
<Line.X2> 

<LengthAnimationCollection> 

<LengthAnimation To="300" Durational 0" RepeatCount="50" /> 
</LengthAnimationCollection> 
</Line.X2> 
</Line> 

The third line's animation has only its By property set. The By of an animation specifies "by how much" 
the animation changes a value over its duration. As in the previous example, the animation uses the base 
value of the property it is animating or the ending value of a previous animation. In this example, the 
animation uses the base value of the line's X2 property, 100, as its starting value, and adds 300 to that 
value over a duration of 10 seconds. 

<Line ID="Line3" X1="10" Y1="130" X2="100" Y2="130" Stroke="Black" StrokeThickness="5"> 
<Line.X2> 
<LengthAnimationCollection> 
<LengthAnimation By="300" Durational 0" RepeatCount="50" l> 
</LengthAnimationCollection> 
</Line.X2> 
</Line> 



The fourth line's animation has its By and From properties set. As a result, the line's X2 attribute is 
animated from 50 to to 350 over a duration of 10 seconds. 

<Line ID="Line4" X1="10" Y1="190" X2="100" Y2="190" Stroke="Black" StrokeThickness="5"> 
<Line.X2> 

<LengthAnimationCollection> 
<LengthAnimation From="50" By="300" Durational 0" RepeatCount= , •50 , ' /> 
</LengthAnimationCollection> 
</Line.X2> 
</Line> 



The fifth line's animation has only its From value set. When an animation has no explicit destination value, 
it uses the base value of the property it is animating or the output of a previous animation as its 
destination value. In this case, the line's X2 attribute is animated from 50 to 100. 

<Line ID=Tine5" X1="10" Y1="250" X2="100" Y2="250" Stroke="Black" StrokeThickness="5"> 
<Line.X2> 
<LengthAnimationCollection> 

<LengthAnimation From="50" Durational 0" RepeatCount="50" /> 
</LengthAnimationCollection> 
</Line.X2> 
</Line> 
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</Canvas> 



This example demonstrates how to create an animation that repeats indefinitely. To make an animation 
repeat indefinitely in "XAML", set the animation's RepeatDuration property to Indefinite. In code, set the 
animation's RepeatDuration property to Time. Indefinite or set its RepeatCount property to 
double. Positivelnfinity. 

In the following examples, a LengthAnimation is set to repeat indefinitely. Although this example uses a 
LengthAnimation, the procedure is the same for all the animation classes. 

<Canvas ID="root" 

xmlns="http://schemas.microsoft.com/2003/xaml"> 

<Line X1="10" Y1="20" X2="50" Y2="20" 
StrokeThickness="1 0" Stroke="Black"> 
<Line.X2> 

<LengthAnimationCollection> 
<LengthAnimation From="30" To="300" Duration="10" 
RepeatDuration="lndefinite" /> 
</LengthAnimationCollection> 
</Line.X2> 
</Line> 

</Canvas> 

//C# 

Line myLine = new Line(); 

LengthAnimation myLengthAnimation = new LengthAnimation(); 
myLength Animation. From = new Length(30); 
myLengthAnimation.To = new Length(300); 
myLengthAnimation.Duration = new Time(1 0000); 
myLengthAnimation. RepeatDuration = Time. Indefinite; 

LengthAnimationCollection collection = new LengthAnimationCollection(); 
collection.Add(myLengthAnimation); 

myLine.SetAnimations(Line.X2Property, collection); 

'VB.NET 

Dim myLine As new MSAvalon.Windows.Shapes.Line 

Dim myLengthAnimation As new MSAvalon. Windows. Media. Animation.LengthAnimation 
myLengthAnimation. From = new MSAvalon. Windows. Length(30) 
myLengthAnimation.To = new MSAvalon. Windows. Length(300) 
myLengthAnimation.Duration = new MSAvalon.Windows.Media.Animation.Time(IOOOO) 
myLengthAnimation. RepeatDuration = _ 
MSAvalon.Windows.Media.Animation.Time.lndefinite 

Dim collection As new MSAvalon.Windows.Media.Animation.LengthAnimationCollection 
collection.Add(myLengthAnimation) 

myLine.SetAnimations(Line.X2Property, collection) 
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D ubleAnimationC llection Class 

Definition: Represents a collection of DoubleModifier animations. 



Meth d 

Add 

AddChild 

AddText 

Apply 

Clear 
CloneCore 

CloneDownToUnchangeable 

Contains 
Copy 

Copy 

CopyTo 

Disable 
Disablelmpl 

DoubleAnimationCollection 



Description 

The Add(DoubleModifier) and Add(Object) methods add animations to 
the collection. The Add(Double, DoubleAnimationCollection) method 
calculates the current value of the specified collection based on the 
specified base value. 

Implementation of AddChild. Adds a Modifier to this AnimationCollection 
from Markup. 

Implementation of AddText. This is not implemented on this class. 

Implementation of Apply. Applies an animation collection in markup to an 
element. 

Clears the collection by setting the collection's Count to 0. 
CloneCore 

Returns an immutable copy of the specified object. Inherited from 
Changeable. 

Returns a Boolean that indicates whether the collection contains the 
specified DoubleModifier. 

Creates a copy of this DoubleAnimationCollection. 

Returns a modifiable copy of the current object. The copy's IsChangeable 

property is true and its StatusOfNextUse is Unchangeable. Inherited from 

Changeable. 

Copies the entire DoubleAnimationCollection to the specified one- 
dimensional array, starting at the specified index of the target array. 
Inherited from AnimationCollection. 



Creates an empty DoubleAnimationCollection with a default capacity for 
a single animation. 

Accesses the specified Changeable data member, processes it, and 
returns a reference to the member. This reference should then be 
EmbeddedChangeableReader reassigned to the original member variable. Classes that derive from 

Changeable call this method on data members before they can be 
retrieved through property calls. Inherited from Changeable. 
Processes a modified Changeable data member and returns a reference 
to the processed object. Inherited from Changeable. 
Inherited from AnimationCollection. 



EmbeddedChangeableWriter 

Enable 
Enablelmpl 

Equals 



Finalize 

GetEnumerator 
GetEnumeratorlmpI 

GetHashCode 



Determines whether two Object instances are equal. Inherited from 
Object. 

Allows an Object to attempt to free resources and perform other cleanup 
operations before the Object is reclaimed by garbage collection. Inherited 
from Object. 

GetEnumerator Inherited from AnimationCollection. 

Returns an object that can be used to enumerate items in the list. 

Serves as a hash function for a particular type, suitable for use in 

hashing algorithms and data structures like a hash table. Inherited from 

Object. 
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GetType 

GetValue 

GetValuelmpI 

IndexOf 

Insert 

MakeUnchangeable 

MakeUnchangeableCore 
MemberwiseClone 



ModifyHandlerlfChangeable 

OnChanged 
op_Addition 
opjmplicit 

PropagateEventHandler 
ReadPreamble 

ReferenceEquals 

Remove 
RemoveAt 

SetDefaultParentTimeline 
SetValuelmpI 

ToString 

ValidateObjectState 
WritePostscript 

WritePreamble 



Gets the Type of the current instance. Inherited from Object. 
Returns the current value of the animation. 
Provides a Modifier at a given index. 



Makes an object immutable; after this method is called on a Changeable, 
its IsChangeable property is false. Inherited from Changeable. 
Implementation of MakeUnchangeableCore. 
Creates a shallow copy of the current Object. Inherited from Object. 
Adds or removes a Changed event handler to or from the specified 
Changeable object, if the object is currently modifiable. If the specified 
object is not modifiable— if its IsChangeable property is false— this 
method has no effect. Inherited from Changeable. 
OnChanged 



Implementation of PropagateEventHandler. 

Ensures that simple (non-Changeable) members are being accessed 
from a valid Ul context. This method should be called before any simple 
members are accessed. Inherited from Changeable. 

Determines whether the specified Object instances are the same 
instance. Inherited from Object. 



Inherited from AnimationCollection. 
Sets a Modifier at a given index. 

Returns a String that represents the current Object. Inherited from 
Object. 

Verifies that the current object has a valid state. If the object is in an 
invalid state, this method throws an exception. Inherited from 
Changeable. 

Causes the current object to validate itself and then invokes the 
OnChanged method. Inherited from Changeable. 
Ensures that simple (non-Changeable) members are being accessed 
from a valid user interface (Ul) context. This method should be called 
before any simple members are set. Inherited from Changeable. 



Property Description 

Used in conjunction with the ChangeableUsageOverride type sent in 
AllowChangeableReferenceOverride as a P arameter t0 ChangeableHelper.UseChangeable, to help 

determine when a Changeable being put into "use" should be 
promoted to "ChangeableReference". Inherited from Changeable. 
AnimationType AnimationType 

CanMakeUnchangeable True if this Chan 9eable can be made unchangeable. Inherited from 

Changeable. 

Count Inherited from AnimationCollection. 

Countlmpl 

E ™Pty An unchangeable empty DoubleAnimationCollection. 
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IsChangeable 

IsChanging 
IsFixedSize 

IsOverridingBaseValue 

IsReadOnly 

IsSynchronized 

IsUsingBaseValue 

IsUsingBaseValuelmpI 

Item 

Item 



StatusOfNextUse 

SyncRoot 
UlContext 



Gets a Boolean that indicates whether the object is currently 
modifiable. Inherited from Changeable. 

Returns true if at least one of the animations in the animation list is 
currently active. Inherited from AnimationCollection. 

Returns true if at least one of the animations in the animation list is 
currently on. Inherited from AnimationCollection. 



Inherited from AnimationCollection. 



this - typed version of indexer 

Use this to get or set a Modifier at a given index. Inherited from 
AnimationCollection. 

Gets or sets a UseStatus enumeration that specifies how the 
Changeable object behaves when it is "used." A Changeable object 
is considered used in the following situations: the object is set into a 
Property System property, the object is used as a sub-object in a 
complex Changeable object, or the object is used in a 
DrawingContext command. Inherited from Changeable. 

Gets the UlContext of the current object. The UlContext is used for 
maintaining thread safety. Inherited from Changeable. 



The AnimationCollection classes, such as DoubleAnimationCollection, provide you with more control over 
how you animate a property than a single animation could. Each of the AnimationCollection classes 
effectively functions as a single composite animation, using all the animations in the collection to animate 
a base value. When a property requests the current value of a DoubleAnimationCollection, the property 
calls the DoubleAnimationCollection's GetValue method and passes it the property's base value. The first 
animation in the collection processes this base value and produces a result, which is then passed to the 
next animation in the collection, and so on, until the value has been processed by all the animations in the 
collection. 



This example demonstrates how to animate the size of an element using "Longhorn" markup language 
(code-named "XAML"). There are multiple ways to animate the size of an element: directly animate the 
height and width attributes of the element, or apply an animated ScaleTransform to the element. In this 
example, two Rectangle elements are resized using these methods. One rectangle is resized by 
animating its RectangleWidth attribute and another is resized by animating a ScaleTransform applied to 
the rectangle. Each rectangle is filled with a pattern to highlight the differences between the two resizing 
methods. Initially, the two patterns look the same, but as the rectangles are resized, patterns change 
depending on how their containing rectangle is resized. 

In the first example, a Rectangle element's RectangleWidth property is animated using a 
LengthAnimationCollection and a LengthAnimation. The LengthAnimation object in this example animates 
the rectangle's RectangleWidth from its base value of 200 To a destination value of 600 over a Duration 
of 10 seconds. 



<Canvas ID="root" 

xmlns= n http://schemas.microsoft.com/2003/xaml"> 



<Rectangle 
RectangleTop="20" 
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RectangleLeft="20" 

RectangleWidth="200" 

RectangleHeight="150" 

Stroke="Red" 

StrokeThickness="5"> 

<Rectangle.Fill> 

<lmageBrush ViewPort="0,0 100,100" ViewPorttlnits="Absolute" 
lmageSource="help.gif TileMode='Tile7> 
</Rectangle.Fill> 

<Rectangle.RectangleWidth> 
<!-- Animate the Rectangle's width: --> 
<LengthAnimationCollection> 
<LengthAnimation 

To="600" Duration= n 10" AutoReverse="true" RepeatCount="50" /> 
</LengthAnimationCollection> 
</Rectangle.RectangleWidth> 

</Rectangle> 

When the previous "XAML" is run, more of the pattern is exposed as the rectangle expands; however, the 
question marks that make up the pattern do not grow larger. 

In the next example, a TransformDecorator is used to apply a ScaleTransform to a rectangle. A 
DoubleAnimation is used to animate the ScaleTransform object's ScaleX value using the 
ScaleXAnimations attribute. The DoubleAnimation animates the ScaleX value From 1 To a destination 
value of 3 over a Duration of 10 seconds. As a result, the rectangle's width is scaled from 100 percent (its 
starting size) to 300 percent over ten seconds. 

<TransformDecorator Affectsl_ayout="False"> 
<TransformDecorator.Transform> 

<!-- Use the ScaleTransform to enlarge the rectangle ~> 
<ScaleTransform ScaleX="r ScaleY="1 M > 
<ScaleTransform.ScaleXAnimations> 
<DoubleAnimation From="1" To="3" RepeatCount="30" 
AutoReverse="True" Begin="0" Durational 0" /> 
</ScaleTransform.ScaleXAnimations> 
</ScaleTransform> 

</TransformDecorator.Transform> 

<Rectangle 
RectangleLeft="20" 
RectangleTop="200" 
RectangleWidth="200" 
RectangleHeight="150" 
Stroke="Black" 
StrokeThickness="3"> 
<Rectangle.Fill> 

<lmageBrush ViewPort="0,0 100,100" ViewPortUnits="Absolute" 
lmageSource="help.gif TileMode="Tile7> 
</Rectangle.Fill> 
</Rectangle> 
</TransformDecorator> 
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</Canvas> 

In the previous example, the DoubleAnimationCollection tag, <DoubleAnimationCollection> is omitted 
when animating the transformation's scale factor. When animating a designated animation property- 
properties of the form PropertyNameAnimations, such as the ScaleXAnimations property in the previous 
example— you may omit the animation collection tag. However, when animating a property of a Ul 
element— those classes that derive from UlElement— you must nest the animations within an animation 
collection tag. 

When the second rectangle expands, the objects in the pattern also grow larger, unlike in the first 
rectangle. The pattern behaves this way because when you transform an element the entire element and 
its child elements are transformed. When you directly alter the size of an element, as in the case of the 
first rectangle, the element's children are not resized, unless their size and position are dependent on the 
size of their parent element. 

This example demonstrates how to animate a property using "XAML". To animate a property, you 
associate the proper animation collection and animations with the property either directly or using the 
property's corresponding animation property. There are a variety of animation classes, each of which 
animates a different kind of value. 

Before some properties can be animated, they must be given a base value. For example, before 
animating the RectangleWidth of a Rectangle, the RectangleWidth must be set to a non-animated value 
(in this case, a Length object). 

In the following example, the Width of a Button is animated. Because the Width property takes a Length, 
a LengthAnimation is needed. A LengthAnimationCollection is used to contain the LengthAnimation. 
Although in this example there is only one animation, you could associate multiple animations with a 
single property by placing the animations within the collection. Because there is no WidthAnimations 
property, the LengthAnimationCollection is associated directly with the button's Width property. 

<Canvas ID="root" 
xmlns="http://schemas.microsoft.com/2003/xamr'> 

<Button Canvas.Top="20" Canvas. Left="20" 
Height="30" Width="200"> 

< Button. Width> 
<LengthAnimationCollection> 
<LengthAnimation To="50" Duration="5" RepeatCount="500" 
AutoReverse='True'7> 
</LengthAnimationCollection> 
</Button.Width> 

A Button 
</Button> 

In the next example, the Background color of a second button is animated. The Background property 
takes a Brush. In this example, a SolidColorBrush is used to fill the button's Background, although a 
gradient, image, or pattern could have been used. To animate the button's background color, the Color of 
the SolidColorBrush must be animated. Because the SolidColorBrush.Color property accepts a Color, a 
ColorAnimation is used to animate the property. The SolidColorBrush.Color property has a corresponding 
ColorAnimations property, so the ColorAnimation is nested within the ColorAnimations property in order 
to animate the color of the brush. 

<Button Canvas.Top="70" Canvas. Left="20" 
Height="30" Width="200"> 
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<Button. Background 
<SolidColorBrush Color="Blue"> 
<SolidColorBrush.ColorAnimations> 
<ColorAnimation From="Red" To- 'Blue" Duration^T' 
RepeatCount="500" AutoReverse= , True , 7> 
</SolidColorBrush.ColorAnimations> 
</SolidColorBrush> 
</Button.Background> 

Another Button 
</Button> 

</Canvas> 

In the previous example, the ColorAnimationCollection tag, <ColorAnimationCollection>, is omitted when 
animating the brush's color. When animating a designated animation property— properties of the form 
PropertyNameAnimations, such as the ColorAnimations property in the previous example— you may omit 
the animation collection tag. However, when animating a property of a Ul element— those classes that 
derive from UlElement— you must nest the animations within an animation collection tag. 

DoubfeKeyFrameCollection Class 

Method Description 

Strongly typed implementation of Add. 
Implementation of CloneCore. 

Returns an immutable copy of the specified object. Inherited from 
Changeable. 

Returns a modifiable copy of the current object. The copy's 
IsChangeable property is true and its StatusOfNextUse is 
Unchangeable. Inherited from Changeable. 
Creates a new DoubleKeyFrameCollection 

Accesses the specified Changeable data member, processes it, and 
returns a reference to the member. This reference should then be 
reassigned to the original member variable. Classes that derive from 
Changeable call this method on data members before they can be 
retrieved through property calls. Inherited from Changeable. 
Processes a modified Changeable data member and returns a 
reference to the processed object. Inherited from Changeable. 

Determines whether two Object instances are equal. Inherited from 
Object. 

Allows an Object to attempt to free resources and perform other cleanup 
operations before the Object is reclaimed by garbage 
collection. Inherited from Object. 
TODO 

Serves as a hash function for a particular type, suitable for use in 
hashing algorithms and data structures like a hash table. Inherited from 
Object. 

Gets the Type of the current instance. Inherited from Object. 
Makes an object immutable; after this method is called on a 
Changeable, its IsChangeable property is false. Inherited from 



Add 

CloneCore 

CloneDownToUnchangeable 

Copy 
Copy 

DoubleKeyFrameCollection 
EmbeddedChangeableReader 

EmbeddedChangeableWriter 
Equals 

Finalize 

GetCurrentSegmentValues 
GetHashCode 
GetType 

MakeUnchangeable 
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MakeUnchangeableCore 
MemberwiseClone 

ModifyHandlerlfChangeable 
OnChanged 

PropagateEventHandler 
ReadPreamble 

ReferenceEquals 

ToString 
Validate 

ValidateObjectState 
WritePostscript 

WritePreamble 



Changeable. 

Makes a Changeable object immutable. Inherited from Changeable. 
Creates a shallow copy of the current Object. Inherited from Object. 
Adds or removes a Changed event handler to or from the specified 
Changeable object, if the object is currently modifiable. If the specified 
object is not modifiable— if its IsChangeable property is false— this 
method has no effect. Inherited from Changeable. 
Called when the current object is modified. Classes that derive from 
Changed should call this method after they have been 
modified. Inherited from Changeable. 

Shares a Changed event handler with the current object's data 
members or removes it. Inherited from Changeable. 
Ensures that simple (non-Changeable) members are being accessed 
from a valid Ul context. This method should be called before any simple 
members are accessed. Inherited from Changeable. 

Determines whether the specified Object instances are the same 
instance. Inherited from Object. 

Returns a String that represents the current Object. Inherited from 
Object. 

Implementation of ValidateObjectState. 

Causes the current object to validate itself and then invokes the 

OnChanged method. Inherited from Changeable. 

Ensures that simple (non-Changeable) members are being accessed 

from a valid user interface (Ul) context. This method should be called 

before any simple members are set. Inherited from Changeable. 



Property 



AllowChangeableReferenceOverride 

CanMakeUnchangeable 

Count 
Destination 

IsChangeable 

Item 



StatusOfNextUse 



UlContext 



Description 

Used in conjunction with the ChangeableUsageOverride type sent 
in as a parameter to ChangeableHelper.UseChangeable, to help 
determine when a Changeable being put into "use" should be 
promoted to "ChangeableReference". Inherited from Changeable. 
True if this Changeable can be made unchangeable. Inherited 
from Changeable. 

Implementation of Count. 

The value specified in the last KeyFrame. 

Gets a Boolean that indicates whether the object is currently 
modifiable. Inherited from Changeable. 

Gets or sets a UseStatus enumeration that specifies how the 
Changeable object behaves when it is "used." A Changeable 
object is considered used in the following situations: the object is 
set into a Property System property, the object is used as a sub- 
object in a complex Changeable object, or the object is used in a 
DrawingContext command. Inherited from Changeable. 
Gets the UlContext of the current object. The UlContext is used for 
maintaining thread safety. Inherited from Changeable. 
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D ubleM difier Class 



Meth d 

CloneCore 

CloneDownToUnchangeable 
Copy 

Copy 

DoubleModifier 



Descripti n 

Returns a modifiable shallow or deep clone of the current object. This 
abstract method must be implemented by classes that derive from 
Changeable. Inherited from Changeable. 

Returns an immutable copy of the specified object. Inherited from 
Changeable. 

Creates a copy of this DoubleModifier 

Returns a modifiable copy of the current object. The copy's 
IsChangeable property is true and its StatusOfNextUse is 
Unchangeable. Inherited from Changeable. 



Accesses the specified Changeable data member, processes it, and 
returns a reference to the member. This reference should then be 
EmbeddedChangeableReader reassigned to the original member variable. Classes that derive from 

Changeable call this method on data members before they can be 
retrieved through property calls. Inherited from Changeable. 
Processes a modified Changeable data member and returns a 
reference to the processed object. Inherited from Changeable. 

Determines whether two Object instances are equal. Inherited from 
Object. 

Allows an Object to attempt to free resources and perform other cleanup 
operations before the Object is reclaimed by garbage 
collection. Inherited from Object. 

Serves as a hash function for a particular type, suitable for use in 
hashing algorithms and data structures like a hash table. Inherited from 
Object. 

Gets the Type of the current instance. Inherited from Object. 



EmbeddedChangeableWriter 
Equals 

Finalize 
GetHashCode 



GetType 
GetValue 



GetValuelmpI 
IModifier.GetValue 

MakeUnchangeable 

MakeUnchangeableCore 
MemberwiseClone 

ModifyHandlerlfChangeable 



OnChanged 
opjmplicit 

PropagateEventHandler 
ReadPreamble 



Inherited from Modifier. 

Makes an object immutable; after this method is called on a 
Changeable, its IsChangeable property is false. Inherited from 
Changeable. 

MakeUnchangeableCore Inherited from Modifier. 

Creates a shallow copy of the current Object. Inherited from Object. 

Adds or removes a Changed event handler to or from the specified 

Changeable object, if the object is currently modifiable. If the specified 

object is not modifiable— if its IsChangeable property is false — this 

method has no effect. Inherited from Changeable. 

Called when the current object is modified. Classes that derive from 

Changed should call this method after they have been 

modified. Inherited from Changeable. 

Implicitly creates an AnimationCollection from a DoubleModifier 
Shares a Changed event handler with the current object's data 
members or removes it. Inherited from Changeable. 
Ensures that simple (non-Changeable) members are being accessed 
from a valid Ul context. This method should be called before any simple 
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ReferenceEquals 

SetDefaultParentTimeline 

ToString 

ValidateObjectState 
WritePostscript 

WritePreamble 



members are accessed. Inherited from Changeable. 

Determines whether the specified Object instances are the same 
instance. Inherited from Object. 

SetDefaultParentTimeline Inherited from Modifier. 

Returns a String that represents the current Object Inherited from 
Object. 

Verifies that the current object has a valid state. If the object is in an 
invalid state, this method throws an exception. Inherited from 
Changeable. 

Causes the current object to validate itself and then invokes the 
OnChanged method. Inherited from Changeable. 

Ensures that simple (non-Changeable) members are being accessed 
from a valid user interface (Ul) context. This method should be called 
before any simple members are set. Inherited from Changeable. 



Property 



Description 

Used in conjunction with the ChangeableUsageOverride type sent in 
AllowChangeableReferenceOverride * s a P aram eterto ChangeableHelper.UseChangeable, to help 

determine when a Changeable being put into "use" should be 
promoted to "ChangeableReference". Inherited from Changeable. 

True if this Changeable can be made unchangeable. Inherited from 
Changeable. 

Gets a Boolean that indicates whether the object is currently 
modifiable. Inherited from Changeable. 

Gets a value that indicates whether the animation is active. Inherited 
from Modifier. 



CanMakeUnchangeable 

IsChangeable 

IsChanging 



I sOverriding Base Va lue 

StatusOfNextUse 

UlContext 
UsesBaseValue 



Gets a value that indicates whether the animation is active or in a fill 
period. Inherited from Modifier. 

Gets or sets a UseStatus enumeration that specifies how the 
Changeable object behaves when it is "used." A Changeable object 
is considered used in the following situations: the object is set into a 
Property System property, the object is used as a sub-object in a 
complex Changeable object, or the object is used in a 
DrawingContext command. Inherited from Changeable. 
Gets the UlContext of the current object. The UlContext is used for 
maintaining thread safety. Inherited from Changeable. 
UsesBaseValue Inherited from Modifier. 



This example demonstrates how to animate the size of an element using "Longhorn" markup language 
(code-named "XAML"). There are multiple ways to animate the size of an element: directly animate the 
height and width attributes of the element, or apply an animated ScaleTransform to the element. In this 
example, two Rectangle elements are resized using these methods. One rectangle is resized by 
animating its RectangleWidth attribute and another is resized by animating a ScaleTransform applied to 
the rectangle. Each rectangle is filled with a pattern to highlight the differences between the two resizing 
methods. Initially, the two patterns look the same, but as the rectangles are resized, patterns change 
depending on how their containing rectangle is resized. 

In the first example, a Rectangle element's RectangleWidth property is animated using a 
LengthAnimationCollection and a LengthAnimation. The LengthAnimation object in this example animates 
the rectangle's RectangleWidth from its base value of 200 To a destination value of 600 over a Duration 
of 10 seconds. 
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<Canvas ID="root" 

xmlns= ,, http://schemas.microsoft.com/2003/xamr , > 

<Rectangle 
RectangleTop="20" 
RectangleLeft="20 n 
RectangleWidth="200" 
RectangleHeight= M 150" 
Stroke="Red" 
StrokeThickness="5"> 

<Rectangle.Fill> 

<imageBrush ViewPort="0,0 100,100" ViewPortUnits= M Absolute" 
lmageSource="help.gif TileMode='Tile"/> 
</Rectangle.Fill> 

<Rectangle.RectangleWidth> 
<!-- Animate the Rectangle's width: --> 
<LengthAnimationCollection> 
<LengthAnimation 

To= M 600" Durational 0" AutoReverse="true" RepeatCount="50" /> 
</LengthAnimationCollection> 
</Rectangle.RectangleWidth> 

</Rectangle> 

When the previous "XAML" is run, more of the pattern is exposed as the rectangle expands; however, the 
question marks that make up the pattern do not grow larger. 

In the next example, a TransformDecorator is used to apply a ScaleTransform to a rectangle. A 
DoubleAnimation is used to animate the ScaleTransform object's ScaleX value using the 
ScaleXAnimations attribute. The DoubleAnimation animates the ScaleX value From 1 To a destination 
value of 3 over a Duration of 10 seconds. As a result, the rectangle's width is scaled from 100 percent (its 
starting size) to 300 percent over ten seconds. 

<Transform Decorator AffectsLayout="False M > 
<TransformDecorator.Transform> 

<!-- Use the ScaleTransform to enlarge the rectangle -> 
<ScaleTransform ScaleX="1 " Scale Y="1"> 
<ScaleTransform.ScaleXAnimations> 
<DoubleAnimation From-T' To- '3" RepeatCount="30" 
AutoReverse= u True" Begin="0" Durational 0" /> 
</ScaleTransform.ScaleXAnimations> 
</ScaleTransform> 

</TransformDecorator.Transform> 

<Rectangle 
RectangleLeft="20" 
RectangleTop="200" 
RectangleWidth="200" 
RectangleHeight="150" 
Stroke="Black" 
StrokeThickness="3"> 
<Rectangle.Fill> 
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<lmageBrush ViewPort= M 0,0 100,100" ViewPortUnits="Absolute" 
lmageSource="help.gif TileMode="Tile7> 
</Rectangle.Fill> 
</Rectangle> 
</TransformDecorator> 

</Canvas> 

In the previous example, the DoubleAnimationCollection tag, <DoubleAnimationCollection> is omitted 
when animating the transformation's scale factor. When animating a designated animation property- 
properties of the form PropertyNameAnimations, such as the ScaleXAnimations property in the previous 
example-you may omit the animation collection tag. However, when animating a property of a Ul 
element-those classes that derive from UlElement-you must nest the animations within an animation 
collection tag. 

When the second rectangle expands, the objects in the pattern also grow larger, unlike in the first 
rectangle The pattern behaves this way because when you transform an element the entire element and 
its child elements are transformed. When you directly alter the size of an element, as in the case of the 
first rectangle, the element's children are not resized, unless their size and position are dependent on the 
size of their parent element. 



DoubleTimedModifier Class 



Method 



Beginln 



CloneCore 

CloneDownToUnchangeable 
Copy 

Copy 

Copy 
Disable 

DoubleTimedModifier 



Description 

Starts or restarts the animation at the specified offset from the current 
time. 

Returns a modifiable shallow or deep clone of the current object. This 
abstract method must be implemented by classes that derive from 
Changeable. Inherited from Changeable. 

Returns an immutable copy of the specified object. Inherited from 
Changeable. 

Creates a copy of this DoubleTimedModifier 
Returns a modifiable copy of the current object. The copy's 
IsChangeable property is true and its StatusOfNextUse is 
Unchangeable. Inherited from Changeable. 

Creates a copy of this DoubleModifier Inherited from DoubleModifier. 
Disables this timeline, after which the timeline can no longer become 
active. The timeline can be re-enabled with a call to Enable. 



EmbeddedChangeableReader 



Accesses the specified Changeable data member, processes it, and 
returns a reference to the member. This reference should then be 
reassigned to the original member variable. Classes that derive from 
Changeable call this method on data members before they can be 
retrieved through property calls. Inherited from Changeable. 

EmbeddedChangeableWriter Processes a modified Changeable data member and returns a reference 

to the processed object. Inherited from Changeable. 

Enables this timeline, parenting it to the timeline specified by the 
ParentTimeline property. This allows the timeline to become active. This 
method throws an exception if the ParentTimeline property is null. 
Schedules an interactive end time. 



Enable 



Endln 
Equals 



Determines whether two Object instances are equal. Inherited from 
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FilllnClone 
Finalize 

GetHashCode 

GetType 
GetValue 
GetValuelmpI 
IModifier.GetValue 

MakeUnchangeable 

MakeUnchangeableCore 
MemberwiseClone 

ModifyHandlerlfChangeable 

OnChanged 

opjmplicit 
Pause 

PropagateEventHandler 
ReadPreamble 

ReferenceEquals 

Resume 

Seek 

SetDefaultParentTimeline 
ToString 

ValidateObjectState 
WritePostscript 

WritePreamble 



Object. 

Allows an Object to attempt to free resources and perform other cleanup 
operations before the Object is reclaimed by garbage 
collection. Inherited from Object. 

Serves as a hash function for a particular type, suitable for use in 
hashing algorithms and data structures like a hash table. Inherited from 
Object. 

Gets the Type of the current instance. Inherited from Object. 
Inherited from DoubleModifier. 
Inherited from DoubleModifier. 
Inherited from Modifier. 

Makes an object immutable; after this method is called on a 
Changeable, its IsChangeable property is false. Inherited from 
Changeable. 

MakeUnchangeableCore Inherited from Modifier. 

Creates a shallow copy of the current Object. Inherited from Object. 

Adds or removes a Changed event handler to or from the specified 

Changeable object, if the object is currently modifiable. If the specified 

object is not modifiable— if its IsChangeable property is false— this 

method has no effect. Inherited from Changeable. 

Called when the current object is modified. Classes that derive from 

Changed should call this method after they have been 

modified. Inherited from Changeable. 

Implicitly creates an AnimationCollection from a 

DoubleModifier Inherited from DoubleModifier. 

Pauses this timeline. 

Ensures that simple (non-Changeable) members are being accessed 
from a valid Ul context. This method should be called before any simple 
members are accessed. Inherited from Changeable. 

Determines whether the specified Object instances are the same 
instance. Inherited from Object. 

Resumes this timeline. 

Moves the current position of the animation backwards or forwards from 
either the current time, the Begin time, or the End time. 
SetDefaultParentTimeline Inherited from Modifier. 

Returns a String that represents the current Object. Inherited from 
Object. 

Verifies that the current object has a valid state. If the object is in an 
invalid state, this method throws an exception. Inherited from 
Changeable. 

Causes the current object to validate itself and then invokes the 
OnChanged method. Inherited from Changeable. 
Ensures that simple (non-Changeable) members are being accessed 
from a valid user interface (Ul) context. This method should be called 
before any simple members are set Inherited from Changeable. 



Pr perty 



Descripti n 
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Acceleration 

AllowChangeableReferenceOverride 

Auto Reverse 
Begin 

CanMakeUnchangeable 

CurrentRepeat 
CurrentTime 

Deceleration 

Duration 
End 

EndSync 
Fill 

FillDefault 

IsChangeable 

IsChanging 
IsEnabled 

IsForwardProgressing 

IsOverridingBaseValue 

IsPaused 

IsReversed 
ParentTimeline 
Progress 
RepeatCount 

RepeatDuration 
Restart 

RestartDefault 



Gets or sets the fraction of the simple duration spent in the 
acceleration phase. 

Used in conjunction with the ChangeablellsageOverride type sent 
in as a parameter to ChangeableHelper.UseChangeable, to help 
determine when a Changeable being put into "use" should be 
promoted to "ChangeableReference". Inherited from Changeable. 
Gets or sets a value that indicates whether the animation plays in 
reverse after it completes its forward iteration. 
Gets or sets an offset to the start time of the animation. 

True if this Changeable can be made unchangeable. Inherited 
from Changeable. 

Gets the number of the current iteration of the animation. 
Gets the current time value of the animation. 

Gets or sets a value that represents the fraction of the simple 

duration spent in the deceleration phase. 

Gets or sets the length of time the animation takes to complete a 

single forward iteration, also known as the simple duration of an 

animation. 

Gets or sets the maximum end time of the animation. 
Gets or sets a TimeEndSync enumeration that specifies how the 
implicit duration of an animation is determined. This property is 
only used if the Duration property is not explicitly set. 

Gets or sets a value that specifies the state of an object when its 
animation ends. 

Gets or sets a value that indicates the default value of the Fill 
property of the current animation and its child timelines. 
Gets a Boolean that indicates whether the object is currently 
modifiable. Inherited from Changeable. 

Gets a value that indicates whether the animation is active. 

Gets a value that indicates whether the animation is progressing 
from past to future. 

Gets a value that indicates whether the animation is active or in a 
fill period. 

Gets a value that indicates whether the animation is active and 
paused. 

Gets a value that indicates whether the animation is currently 
moving in the opposite direction of its parent timeline. 
Gets or sets the default parent timeline of the animation. 

Gets a number from 0 to 1 that indicates the fraction of the simple 
duration that has elapsed. 

Gets or sets the number of times an animation should repeat. 
Gets or sets the total length of time the animation should play. If 
this value is greater than the simple duration of the animation, it 
will repeat itself for the length of time specified by this property. 
Gets or sets the animation's behavior when it is told to restart- 
that is, how the animation behaves when a second begin time is 
reached. 

Gets or sets the default value of the Restart property of the current 
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